vscode需通过rustup安装cargo和rustc并正确配置path，否则rust-analyzer无法启动；必须在含cargo.toml的目录下打开项目，禁用rls等旧插件，调试需确保debug info启用且launch.json使用动态路径。
VSCode 本身不带 Rust 运行能力，cargo 和 rustc 必须由 rustup 安装并正确暴露在 PATH 中，否则所有插件（包括 rust-analyzer）都会失效——不是插件没装好，是根本没启动语言服务器。
cargo --version 在终端能跑，但 VSCode 里报 “command not found”
这是最常见卡点，本质是 VSCode 启动时没继承 shell 的 PATH。Mac/Linux 用户直接双击图标打开 VSCode，$HOME/.cargo/bin 就不会被加载；Windows 用户若用开始菜单启动，且安装 rustup 时没勾选 “Add to PATH”，也会一样。
- Mac/Linux：关闭 VSCode，从终端执行
code .（确保当前目录是项目根），它会继承 shell 环境变量 - Windows：检查系统环境变量里是否包含
%USERPROFILE%\.cargo\bin；若没有，重装rustup-init.exe并务必勾选 “Add to PATH” - 验证方式：在 VSCode 内置终端（
Ctrl+`）中运行cargo --version和rustc --version，两者都必须有输出 - 别依赖 “Reload Window”，要彻底退出 VSCode 再重开——reload 不刷新环境变量
Rust Analyzer 报 “No Rust project detected” 或一直 “Loading…”
它只认工作区根目录下的 Cargo.toml，不会递归搜索子目录。你打开的是 ~/myproject/crates/utils，但 code . 是在 ~/myproject 下执行的，Analyzer 就看不到 utils/Cargo.toml。
- 确保 VSCode 是在含
Cargo.toml的目录下打开的，比如code ./crates/utils - 多 crate 工作区建议加
rust-project.json显式声明，内容为：{"sysroot":"discover","crates":[{"root_module":"./Cargo.toml","deps":[],"cfg":[]}]} - 禁用所有叫 “Rust”（作者 rust-lang）或 “RLS” 的插件，只留
rust-analyzer（作者 matklad） - 如果状态栏右下角没出现
[rust-analyzer]，按Ctrl+Shift+P→ 输入Rust Analyzer: Reload Workspace手动触发
断点不命中、调试器找不到可执行文件
VSCode 默认生成的 launch.json 往往用 cargo run，这会导致断点不稳定；更关键的是，“program” 路径写死后容易因项目名含连字符（如 my-app → 编译成 my_app）而失败。
- 手动改
.vscode/launch.json，把"args"改成["build"]，避免每次调试都重新编译 -
"program"别硬写./target/debug/my-app，改用动态路径："program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}"（注意：Cargo 会自动把-转成_，所以my-app对应二进制名是my_app） - 确认
Cargo.toml里没设[profile.dev.debug = 0]，否则 debug info 被 strip，断点无效 - 调试前先手动跑一次
cargo build（不是cargo build --release），确保target/debug/下有对应二进制
真正容易被忽略的是：删除 target/ 目录后，rust-analyzer 的语义索引不会自动重建，导致大量 “unresolved import” 却能正常编译；遇到这种情况，别反复 reload，直接执行 Rust Analyzer: Reload Workspace，再等几秒看输出面板日志里有没有 project model loaded。
