VSCode运行Rust必须同时满足三项：正确安装rustup工具链并确保cargo/rustc在PATH中、安装官方rust-analyzer插件（禁用已弃用的rust-lang.rust）、在含Cargo.toml的目录下打开项目；缺任一环均导致“No Rust project detected”或卡在“Loading…”。
VSCode 要真正跑 Rust，不是装几个插件就完事——rust-analyzer 必须配上 rustup 管理的完整工具链，缺一不可；否则你会卡在 “No Rust project detected” 或状态栏一直显示 “Loading…”。
rustc 和 cargo 没进 PATH，VSCode 就根本看不到 Rust
这是 90% 初学者卡住的第一步。终端里 rustc --version 能输出，不代表 VSCode 能用。
- 确认
$HOME/.cargo/bin（macOS/Linux）或%USERPROFILE%\.cargo\bin（Windows）已加入系统PATH - 别从桌面图标启动 VSCode —— 它不继承 shell 的环境变量；改用终端执行
code .打开项目 - Windows 用户额外验证：
cl.exe是否可用（MSVC 工具链必需），可在 “Developer Command Prompt for VS 2022” 中运行测试 - 运行
cargo metadata --no-deps --format-version 1，失败说明Cargo.toml格式异常或 workspace 配置有误，rust-analyzer依赖这个命令建模项目结构
必须装 rust-analyzer，禁用所有叫 “Rust” 的旧插件
VS Code 商店搜 “Rust” 出来的 rust-lang.rust 插件早已弃用，只做语法高亮，不带 LSP 功能；它和 rust-analyzer 冲突会导致跳转失效、#[derive] 不提示。
- 只安装作者为
matklad、图标是蓝色原子结构的rust-analyzer - 立即禁用所有标有 “Rust”（无 “Analyzer” 后缀）、“RLS”、“rust-client” 的插件
- 打开含
Cargo.toml的目录后，右下角应显示rust-analyzer并有进度条；若卡住，用Ctrl+Shift+P→ 输入Rust Analyzer: Reload Workspace手动触发 - 检查输出面板（
Ctrl+Shift+U）中 “Rust Analyzer” 日志，看到project model loaded才算真正就绪
rust-analyzer 配置别乱堆，默认够用，但这几个要调
一堆高级配置反而让服务器启动慢、内存暴涨，甚至加载失败。先稳住基础，再按需加码。
-
rust-analyzer.checkOnSave.command设为check（不是clippy），避免保存时卡住；clippy留给 CI 或手动cargo clippy -
rust-analyzer.cargo.loadOutDirsFromCheck设为true，让其通过cargo check推导target/目录，避开因权限或路径异常导致构建信息缺失 - 需要类型/参数内联提示？开
rust-analyzer.inlayHints.typeHints.enable和rust-analyzer.inlayHints.parameterHints.enable - 项目含
build.rs？加rust-analyzer.cargo.buildScripts.enable: true，否则自定义构建逻辑可能被忽略
调试前不跑 cargo build，CodeLLDB 就会静默失败
装了 CodeLLDB 插件 ≠ 能调试。Windows 上最常报 Failed to launch: could not find lldb，其实是因为工具链不匹配或二进制没生成。
- 确保
rustup show输出中 default host 是x86_64-pc-windows-msvc（非-gnu），否则链接器不兼容 - 项目根目录建
.vscode/launch.json，cargo.args必须明确指定目标，比如["build", "--bin=${fileBasenameNoExtension}"] - 调试前务必先手动运行一次
cargo build，否则 CodeLLDB 找不到可执行文件，断点全灰 - 断点打在
src/main.rs外？默认测试/示例不生成调试信息，需在Cargo.toml加[profile.dev] debug = true或用#[cfg(test)]显式标注
真正容易被忽略的是：工具链、PATH、启动方式三者必须咬合；VSCode 不是从图标点开就有全部环境，而 rust-analyzer 的日志输出（不是弹窗提示）才是唯一可信的状态依据。
