zed-industries/zed · error · anyhow::Error

Clangd does not provide prebuilt binaries for {arch} to fetc

Error message

Clangd does not provide prebuilt binaries for {arch} to fetch from GitHub. Consider installing the binary manually.

What it means

ensure_arch_compatibility bails when running on linux with an architecture other than x86_64/x86, because clangd's GitHub releases only ship prebuilt x86 linux binaries; the user is told to install clangd manually.

Source

Thrown at crates/languages/src/c.rs:165

            .await?;

            Ok(binary)
        }
    }

    async fn cached_server_binary(
        &self,
        container_dir: PathBuf,
        _: &dyn LspAdapterDelegate,
    ) -> Option<LanguageServerBinary> {
        get_cached_server_binary(container_dir).await
    }
}

fn ensure_arch_compatibility() -> Result<()> {
    let arch = consts::ARCH;
    if consts::OS == "linux" && !["x86_64", "x86"].contains(&arch) {
        anyhow::bail!(
            "Clangd does not provide prebuilt binaries for {arch} to fetch from GitHub. Consider installing the binary manually."
        )
    }
    Ok(())
}

#[async_trait(?Send)]
impl super::LspAdapter for CLspAdapter {
    fn name(&self) -> LanguageServerName {
        Self::SERVER_NAME
    }

    async fn label_for_completion(
        &self,
        completion: &lsp::CompletionItem,
        language: &Arc<Language>,
    ) -> Option<CodeLabel> {
        let label_detail = match &completion.label_details {

View on GitHub (pinned to f4178619ac)

Solutions

  1. Install clangd via the system package manager (apt, dnf, pacman, brew) and point Zed at it
  2. Use a supported architecture (x86_64 Linux) or a build of Zed for arm64 where clangd assets exist
  3. Configure the clangd binary path manually in Zed settings to skip GitHub download
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at crates/languages/src/c.rs:165 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of zed-industries/zed@f4178619ac (2026-08-20). Data as JSON: /api/errors/6dd3f95fb248e019. Report an issue: GitHub.