VS Code 需通过 rust-analyzer 插件、正确安装的 rustc/cargo 工具链及合理工作区配置实现 Rust IDE 级体验；须用 rustup 安装工具链、禁用旧 Rust 插件、确保 Cargo.toml 在工作区根目录，并配合 CodeLLDB 调试。
VS Code 本身不内置 Rust 支持，但通过 rust-analyzer 插件 + 正确安装的 rustc 和 cargo，就能获得接近 IDE 的体验。关键不是“装插件”，而是确保工具链路径、语言服务器配置和工作区设置三者对齐。
确认 rustc 和 cargo 已正确安装并可用
VS Code 的 rust-analyzer 依赖系统 PATH 中能直接调用 cargo 和 rustc。如果终端里运行 cargo --version 报错或返回空，VS Code 一定无法启动分析器。
- 推荐用
rustup安装：执行curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh（Linux/macOS）或下载rustup-init.exe（Windows） - 安装后重启终端，再运行
source $HOME/.cargo/env（Linux/macOS）或重新打开 PowerShell/CMD（Windows） - 验证：
cargo --version和rustc --version必须同时输出版本号 - 注意 Windows 用户：避免用 MSYS2 或 Chocolatey 单独装
cargo，容易与rustup冲突
安装 rust-analyzer 并禁用官方 Rust 插件
rust-analyzer 是当前唯一被广泛采用的 Rust 语言服务器；而 VS Code 自带的 “Rust” 插件（由 rust-lang 官方早期维护）已弃用，两者共存会导致符号解析失败、跳转失效甚至 CPU 持续 100%。
- 在扩展市场搜索并安装
rust-analyzer（作者是matklad） - 卸载或禁用名为 “Rust”（图标为红黑齿轮）、作者为 “rust-lang” 的旧插件
- 安装后无需手动启动服务器——只要打开一个
.rs文件或 Cargo 工作区根目录，它会自动拉起 - 如未触发，检查状态栏右下角是否有
[rust-analyzer]，没有则点击它手动选择 “Reload Workspace”
确保 Cargo.toml 在工作区根目录且无多层嵌套
rust-analyzer 默认只识别工作区根目录下的 Cargo.toml。如果你把项目放在 ~/projects/myapp/src/ 里，而 Cargo.toml 在 src/ 下，它会当成纯文件夹而非 Cargo 项目，导致无法解析依赖、找不到 crate、use 补全失效。
- 打开 VS Code 时，用
File → Open Folder...选中含Cargo.toml的那一层目录 - 如果项目结构必须嵌套（如 monorepo），可在工作区根加
.code-workspace，并在settings中配置"rust-analyzer.cargo.loadOutDirsFromCheck": true - 避免用
File → Open File直接打开单个.rs文件——此时 rust-analyzer 不知道 crate 边界
调试 Rust 程序需额外安装 CodeLLDB 和配置 launch.json
语法检查和补全靠 rust-analyzer，但断点、变量查看、步进执行需要调试器。VS Code 默认不带 Rust 调试支持，必须手动接入。
- 安装扩展
CodeLLDB（作者vscode-lldb），它是目前最稳定的 Rust 调试前端 - 确保已安装
llvm-tools-preview组件：rustup component add llvm-tools-preview - 在项目根新建
.vscode/launch.json，内容参考：{ "version": "0.2.0", "configurations": [ { "type": "lldb", "request": "launch", "name": "Debug", "cargo": { "args": ["build", "--bin", "main"], "filter": { "name": "main", "kind": "bin" } }, "args": [], "env": {} } ] } - 注意：
cargo args中的--bin名称必须与src/bin/下文件名或Cargo.toml中[[bin]]名一致
最容易被忽略的是环境变量继承——比如你用 rustup override set 1.75.0 切换了 toolchain，但 VS Code 是从桌面快捷方式启动的，它可能读不到 shell 的 $PATH 和 rustup 配置。此时要么从终端执行 code . 启动编辑器，要么在 settings.json 中显式指定 "rust-analyzer.server.path"。
