rustup 是唯一可信的 rust 工具链入口，必须用官方方式安装：linux/macos 执行 curl --proto '=https' --tlsv1.2 -ssf https://sh.rustup.rs | sh，windows 下载运行 rustup-init.exe；禁用 vscode 中非 rust-analyzer 的 rust 插件，避免 path 冲突和标准库定位失败。
rustup 是唯一可信的工具链入口，别信插件自带安装器
VSCode 里搜到的 “Rust” 插件（无 Analyzer 后缀）或某些带“installer”字样的扩展，会试图自己下载 rustc/cargo——这会导致 PATH 冲突、cargo build 报错、rust-analyzer 无法定位标准库。真实项目中 70% 的“找不到 std”“no such crate”问题都源于此。
必须用官方 rustup 管理：Linux/macOS 执行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh；Windows 下载 rustup-init.exe 并运行。安装后验证三件事：
-
cargo --version≥ 1.70（低于此版本可能不兼容最新rust-analyzer） -
rustup show显示 active toolchain（如stable-x86_64-unknown-linux-gnu） -
rustup component add rust-src已执行（否则跳转定义失效、#[derive]不提示）
rust-analyzer 配置不当会让大型项目卡死
默认配置下，rust-analyzer 会对所有 feature、所有 target 做全量分析，tokio 或 bevy 类项目打开即卡顿 30 秒以上。关键参数必须手动调优：
-
"rust-analyzer.cargo.features": "all"→ 改为"default"或显式列出需要的 feature（如["full", "test-util"]） -
"rust-analyzer.checkOnSave.allTargets": true→ 必须关掉，否则保存时触发cargo check --all-targets，耗时翻倍 - 若项目含
no_std或自定义sysroot，必须在项目根目录放rust-project.json，否则连core::ptr都标红
改完 settings.json 后按 Ctrl+Shift+P → 输入 Restart Rust Server 生效，别只重启 VSCode。
调试必须用 CodeLLDB + launch.json，别依赖图形按钮
VSCode 右上角的 ▶️ 按钮默认调用 cargo run，不进断点、不读环境变量、不支持条件命中。真要调试并发、内存布局或 panic 位置，必须配 launch.json：
{
"version": "0.2.0",
"configurations": [
{
"type": "lldb",
"request": "launch",
"name": "Debug",
"cargo": {
"args": ["build", "--bin=${fileBasenameNoExtension}"]
},
"args": [],
"cwd": "${workspaceFolder}",
"env": { "RUST_BACKTRACE": "1" }
}
]
}
注意三个易漏点：
-
"cargo.args"里必须写--bin=xxx，否则多 bin 项目会跑错目标 - 跨平台编译（如
wasm32-unknown-unknown）必须加--target参数，图形界面不暴露该选项 - Windows 用户若用 MSVC 工具链，
CodeLLDB无法调试；得换Native Debug或切 MinGW
Windows 上 MSVC 和 MinGW 工具链不能混用
装了 Visual Studio 又装 MSYS2，再用 rustup install stable-x86_64-pc-windows-msvc 和 stable-x86_64-pc-windows-gnu 两个工具链，看似灵活，实则埋雷：
-
cargo build默认走 msvc，但cargo clippy可能悄悄切到 gnu，导致 lint 结果不一致 - 第三方 crate（如
openssl-sys）的构建脚本会检测CC_x86_64_pc_windows_msvc环境变量，混用时直接报linker not found - VSCode 终端继承的是当前 shell 的 PATH，PowerShell 里
rustup default stable-x86_64-pc-windows-msvc，但 WSL2 终端里还是 gnu，cargo check输出和编辑器提示对不上
建议：一个项目只绑定一个工具链，通过 rustup override set x86_64-pc-windows-msvc 锁死，别靠全局 default。
