VSCode 需通过 rust-analyzer 插件与 Rust 工具链配合实现 IDE 级开发体验；必须安装 rustup 工具链和 rust-analyzer 扩展，配置环境变量、launch.json 及 workspace 才能支持跳转、调试等功能。
VSCode 本身不原生支持 Rust，但通过 rust-analyzer 插件 + 正确的工具链配置，就能获得接近 IDE 级别的开发体验——包括跳转定义、实时类型检查、自动补全、重构和错误内联提示。
安装 Rust 工具链和 rust-analyzer
缺一不可：没有 cargo 和 rustc，rust-analyzer 就无法解析项目；没有 rust-analyzer，VSCode 只是个带语法高亮的文本编辑器。
- 用
rustup安装完整工具链：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
（Linux/macOS）或从 rust-lang.org/tools/install 下载 Windows 安装器 - 在 VSCode 扩展市场搜索并安装官方插件：
rust-analyzer（注意不是Rust或RLS） - 重启 VSCode，打开一个
Cargo.toml文件或src/main.rs，状态栏右下角应显示rust-analyzer正在加载项目
确保 cargo 和 rustc 在 PATH 中可用
rust-analyzer 启动时会调用 cargo metadata 获取依赖结构。如果报错 "cargo" not found 或 Failed to run `cargo metadata`，说明 VSCode 没继承到 shell 的环境变量。
- macOS/Linux：确认终端中运行
cargo --version成功，然后从终端启动 VSCode：code . - Windows：若用 PowerShell 或 CMD 启动 VSCode，需确保
%USERPROFILE%\.cargo\bin已加入系统 PATH，并重启 VSCode - 验证方式：在 VSCode 终端（
Ctrl+`）中执行cargo --version，必须有输出
配置 rust-analyzer 的关键设置
默认配置对多数项目够用，但以下几项常需手动调整：
- 启用
rust-analyzer.cargo.loadOutDirsFromCheck（设为true）：让插件读取cargo check输出，加快类型检查响应速度 - 禁用
rust-analyzer.procMacro.enable（设为false）：若项目含自定义过程宏且频繁崩溃，可临时关闭以保稳定 - 如使用
rust-toolchain.toml指定 toolchain，确保rust-analyzer.rustcSource设为discover，否则可能误用全局 rustc
调试 Rust 程序需要额外安装 debug adapter
VSCode 自带的调试器不支持 Rust。必须安装 CodeLLDB（推荐）或 Native Debug，并配置 launch.json。
- 安装扩展：
CodeLLDB（由 Vadim Chugunov 维护，支持 macOS/Linux/Windows） - 在项目根目录创建
.vscode/launch.json，内容如下：{ "version": "0.2.0", "configurations": [ { "type": "lldb", "request": "launch", "name": "Debug", "cargo": { "args": ["build", "--bin", "your-binary-name"], "filter": { "name": "your-binary-name", "kind": "bin" } }, "args": [], "cwd": "${workspaceFolder}" } ] } - 确保已生成调试符号：默认
cargo build即可（debug = true在Cargo.toml的[profile.dev]中已启用）
最易被忽略的一点：rust-analyzer 的索引是按工作区（workspace folder）构建的，不是按文件夹嵌套层级。如果你把多个 crate 放在一个父文件夹下，但没用 workspace 声明，它们之间将无法跨 crate 跳转——此时必须在根目录加 Cargo.toml 并声明 [workspace]。
