必须先安装rustup、rustc和cargo，再安装rust-analyzer与CodeLLDB插件；VSCode中通过任务或集成终端运行cargo命令；调试需正确配置launch.json使用${workspaceFolderBasename}动态获取程序路径。
安装 Rust 工具链和 cargo 是前提
VSCode 本身不提供 Rust 编译能力，必须先在系统中装好 rustup、rustc 和 cargo。直接运行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh（Linux/macOS）或下载 rustup-init.exe（Windows）完成安装。安装后重启终端，确认 cargo --version 和 rustc --version 能正常输出。
常见错误现象：cargo 命令未找到，或 VSCode 中提示 “command 'cargo.build' not found”——这说明环境变量没生效，不是插件问题。Windows 用户尤其要注意是否勾选了“将 Rust 添加到 PATH”选项。
必须安装的 VSCode 插件只有两个
Rust 官方推荐的最小插件组合是：rust-analyzer（核心语言服务器）和 CodeLLDB（调试用）。别装 Rust（老旧的 deprecated 插件）或 RLS（已废弃），它们会和 rust-analyzer 冲突，导致代码跳转失效、类型提示卡顿甚至 CPU 占满。
安装后无需额外配置，rust-analyzer 会自动识别项目根目录下的 Cargo.toml 并加载依赖。如果项目打开后没有语法高亮或跳转，检查是否在工作区根目录（即含 Cargo.toml 的文件夹）下打开，而不是只打开了某个 .rs 文件。
cargo build 和 cargo run 在 VSCode 里怎么触发
不需要手动敲命令——VSCode 集成了 cargo 任务，但默认不自动注册。右键点击 main.rs 或任意源文件，选择 “Run Code” 无效；正确方式是：
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入 “Tasks: Run Build Task”，回车 - 首次运行会提示 “Configure Task”，选 “Create
tasks.jsonfile from template” → “Cargo” - 生成的
.vscode/tasks.json默认使用"args": ["build"]，可改成["run"]或["test"]按需调整
更轻量的方式：直接在集成终端（Ctrl+`）里执行 cargo build。注意，终端必须在项目根目录，否则会报错 “no Cargo.toml found in current directory”。
调试时 launch.json 必须指定 program 路径
用 CodeLLDB 调试前，必须生成 .vscode/launch.json，且 "program" 字段不能写死为 target/debug/your_project_name——因为项目名可能含连字符（如 my-app），Cargo 会把它转成下划线（my_app）。写错就提示 “cannot find executable”。
安全写法是用 cargo 动态获取路径：
{
"version": "0.2.0",
"configurations": [
{
"type": "lldb",
"request": "launch",
"name": "Debug",
"program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}",
"args": [],
"cwd": "${workspaceFolder}"
}
]
}
其中 ${workspaceFolderBasename} 会自动取 Cargo.toml 中 [package].name 的值（经 Cargo 标准化后的名称），比手写可靠得多。
容易被忽略的地方：Rust 项目默认启用 debug = true，但如果在 Cargo.toml 里改过 [profile.dev] 设置（比如加了 debug = false），断点会完全不生效——此时必须删掉该配置或设为 true。
