zed-industries/zed · error

Failed to find a debug adapter

Error message

Failed to find a debug adapter

What it means

get_debug_adapter_binary could not resolve any debug adapter for the adapter name in the debug task definition — the DapRegistry has no matching adapter entry. boot_session therefore cannot launch a debug session for this configuration.

Source

Thrown at crates/project/src/debugger/dap_store.rs:254

            breakpoint_store,
            worktree_store,
            sessions: Default::default(),
            adapter_options: Default::default(),
        }
    }

    pub fn get_debug_adapter_binary(
        &mut self,
        definition: DebugTaskDefinition,
        session_id: SessionId,
        worktree: &Entity<Worktree>,
        console: UnboundedSender<String>,
        cx: &mut Context<Self>,
    ) -> Task<Result<DebugAdapterBinary>> {
        match &self.mode {
            DapStoreMode::Local(_) => {
                let Some(adapter) = DapRegistry::global(cx).adapter(&definition.adapter) else {
                    return Task::ready(Err(anyhow!("Failed to find a debug adapter")));
                };

                let settings_location = SettingsLocation {
                    worktree_id: worktree.read(cx).id(),
                    path: RelPath::empty(),
                };
                let dap_settings = ProjectSettings::get(Some(settings_location), cx)
                    .dap
                    .get(&adapter.name());
                let user_installed_path = dap_settings.and_then(|s| match &s.binary {
                    DapBinary::Default => None,
                    DapBinary::Custom(binary) => {
                        let path = PathBuf::from(binary);
                        Some(worktree.read(cx).resolve_relative_path(path))
                    }
                });
                let user_args = dap_settings.and_then(|s| s.args.clone());
                let user_env = dap_settings.and_then(|s| s.env.clone());

View on GitHub (pinned to f4178619ac)

Solutions

1. Check the adapter name in the debug scenario for typos
2. Install or register the required debug adapter extension/package
3. Verify the adapter is available in the current environment (some are platform-specific)

When it happens

Trigger: Thrown at crates/project/src/debugger/dap_store.rs:254 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/90e963424b028651. Report an issue: GitHub.