推荐直接安装 rustup 管理工具链，而非 VSCode 插件自带安装器；Rust Analyzer 仅作语言服务器，cargo/rustc 必须由 rustup 安装并配置 PATH；Windows/macOS/Linux 安装方式不同，需验证版本、禁用冲突插件、正确配置检查命令与项目环境。
直接装 rustup 就行，别用 VSCode 插件自带的 Rust 安装器——它不管理工具链版本，后期 Cargo 报错率高。
rustup 是唯一推荐的安装入口
VSCode 里搜 “Rust Analyzer” 插件只是语言服务器，不带编译器。真正干活的 cargo、rustc 必须由 rustup 管理：
- Windows 用户去
https://rustup.rs下载并运行rustup-init.exe（别用 PowerShell 的Invoke-WebRequest手动下，证书容易失败） - macOS / Linux 直接终端跑：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - 安装时选 “1) Proceed with installation (default)” 即可，别手抖选“custom”——
cargo和rustc默认路径会进$HOME/.cargo/bin，VSCode 能自动识别 - 装完重启终端，执行
cargo --version和rustc --version确认输出正常
Rust Analyzer 插件必须启用，但别开 rust-client
VSCode 商店搜 “Rust Analyzer”，装官方那个（作者是 matklad）。它替代了旧版 rust 插件（已弃用）：
- 卸载任何标有 “Rust”（无 “Analyzer” 后缀）或 “rls” 的插件，否则会和 Rust Analyzer 冲突，导致代码跳转失效或
#[derive]不提示 - 在设置里搜
rust-analyzer.checkOnSave.command，设为check（不是clippy），避免保存时卡住——Clippy 检查留到 CI 或手动跑cargo clippy - 如果项目用
no_std或自定义sysroot，需在项目根目录加rust-project.json，否则 Analyzer 无法解析内核级 crate
Cargo 命令别全靠快捷键，关键操作得敲终端
VSCode 集成终端（Ctrl+`）比图形化按钮更稳，尤其涉及环境变量或交叉编译时：
-
cargo new myproj --bin：生成可执行项目，别用插件右键菜单里的 “New Project”，它不写.gitignore且默认没开edition = "2021" -
cargo add serde --features=derive：比手动改Cargo.toml少出错，尤其处理 feature 开关时 -
cargo build --target wasm32-unknown-unknown：跨平台编译必须显式指定--target，VSCode 任务配置容易漏掉这个参数，直接终端敲最保险 - 遇到
error: could not compile `xxx` due to 1 previous error，先看是不是cargo check没过就点了运行——Rust Analyzer 的实时检查有时滞后，以终端cargo check输出为准
Windows 上 PATH 和 shell 初始化最容易翻车
rustup 默认把 $HOME/.cargo/bin 加进用户 PATH，但 VSCode 启动方式会影响是否生效：
- 如果从开始菜单点开 VSCode，PATH 通常 OK；但如果从 Git Bash 或 PowerShell 终端里用
code .启动，可能读不到 Windows 用户环境变量——此时在 VSCode 终端里跑echo $PATH，确认含.cargo/bin - Mac 用户若用 zsh，确保
~/.zshrc里有source $HOME/.cargo/env；用 fish 的得加source $HOME/.cargo/env.fish - VSCode 设置里搜
terminal.integrated.env，可手动补 PATH："terminal.integrated.env.linux": {"PATH": "/home/xxx/.cargo/bin:${env:PATH}"}
工具链版本漂移和 PATH 加载时机是实际开发中最常卡住的两个点，其他配置基本一装就灵。
