zed-industries/zed · error

URL conversion to file path failed for "{}"

Error message

URL conversion to file path failed for "{}"

What it means

clangd's textDocument/switchSourceHeader returned a non-empty URL string, but converting that URL to a local file path (e.g. Url::to_file_path or path decode) failed. The server responded, yet with a URI that is not a valid file:// URL pointing at a local path, so the corresponding path-style-aware conversion guard rejects it.

Source

Thrown at crates/editor/src/clangd_ext.rs:90

                })
                .await
                .with_context(|| {
                    format!("Switch source/header LSP request for path \"{source_file}\" failed")
                })?
        };

        if switch_source_header.0.is_empty() {
            return Ok(());
        }
        let path_style = workspace.update(cx, |ws, cx| ws.path_style(cx));
        let path = Url::parse(&switch_source_header.0).with_context(|| {
            format!(
                "Parsing URL \"{}\" returned from switch source/header failed",
                switch_source_header.0
            )
        })?;
        let path = path.to_file_path_ext(path_style).map_err(|()| {
            anyhow::anyhow!(
                "URL conversion to file path failed for \"{}\"",
                switch_source_header.0
            )
        })?;

        workspace
            .update_in(cx, |workspace, window, cx| {
                workspace.open_abs_path(
                    path,
                    OpenOptions {
                        visible: Some(OpenVisible::None),
                        ..Default::default()
                    },
                    window,
                    cx,
                )
            })
            .with_context(|| {

View on GitHub (pinned to 5a9b9558db)

Solutions

1. Log the offending URL and skip the source/header jump, showing the user that the counterpart file could not be located
2. Check that clangd is a recent version returning proper file:// URIs; remote or non-file URIs are not supported here
3. Fall back to other heuristics (extension swapping .h/.cpp) for locating the counterpart file

When it happens

Trigger: Thrown at crates/editor/src/clangd_ext.rs:87 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zed-industries/zed@5a9b9558db (2026-08-20). Data as JSON: /api/errors/5081ff060c983b45. Report an issue: GitHub.