VS Code 跑 Rust 项目必须装 rust-analyzer 和 CodeLLDB，配好 MSVC 工具链；rust-analyzer 需开启 autoimport、inlayHints 和 clippy 检查；调试前须运行 cargo build 并正确配置 launch.json。

VS Code 要能真正跑 Rust 项目、调试不卡壳，光装 rust-analyzer 不够——缺 CodeLLDB 就没法断点，没配好 MSVC 工具链就根本连 cargo run 都失败。

rust-analyzer 不是装上就完事：必须开这几个关键开关

默认安装后，rust-analyzer 只提供基础语法检查，补全弱、类型提示不显、宏展开卡顿。真实开发中容易踩的坑是：改了代码但补全没反应，或者跳转定义失效，其实只是配置没生效。

• 打开 VS Code 设置（Ctrl+,），搜 rust-analyzer.completion.autoimport.enable → 开启，输入函数名时自动补 use 语句
• 启用 rust-analyzer.inlayHints.typeHints.enable 和 rust-analyzer.inlayHints.parameterHints.enable，参数类型和返回值直接显示在代码右侧，不用 hover
• 把 rust-analyzer.check.command 改成 "clippy"，让保存时跑的是 cargo clippy 而非 cargo check，提前揪出常见误用（比如 clone() 冗余）
• 大型项目建议加 "rust-analyzer.cargo.buildScripts.enable": true，否则自定义构建脚本（如 build.rs）可能被忽略，导致编译失败却报错不明

调试失败八成是因为 CodeLLDB 没配对工具链

Windows 上最常遇到的调试错误是：Failed to launch: could not find lldb 或启动后直接退出。根本原因不是插件没装，而是 CodeLLDB 找不到匹配的调试器二进制，或 Rust 工具链本身没链接能力。

VS Code Node

通过作为 OpenClaw 节点连接的 VS Code/Cursor IDE 操作代码，提供 40 多种命令，涵盖文件操作、语言智能、Git、测试等功能。

下载

• 确认已安装 MSVC 工具链（不是 MinGW）：rustup show 输出中 default host 应为 x86_64-pc-windows-msvc；若为 -gnu，需重装并指定 host
• 安装 CodeLLDB 后，必须在项目根目录下建 .vscode/launch.json，内容不能只抄模板，要确保 cargo 字段指向正确的 binary 名：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "lldb",
      "request": "launch",
      "name": "Debug",
      "cargo": {
        "args": ["build", "--bin=${fileBasenameNoExtension}"]
      },
      "args": [],
      "cwd": "${workspaceFolder}"
    }
  ]
}

• 调试前务必先运行一次 cargo build，否则 CodeLLDB 会因找不到可执行文件而静默失败
• 如果断点灰色不生效，检查是否在 src/main.rs 或 src/lib.rs 外的文件里打点——Rust 默认不为测试/示例生成调试信息，需手动加 #[cfg(test)] 或在 Cargo.toml 中设 [profile.dev] debug = true

别让 Better TOML 和 Crates 插件沦为摆设

这两个插件看似辅助，实际影响日常效率：TOML 文件写错一个引号，cargo 就拒绝构建；依赖版本过旧却不提醒，后期升级冲突爆炸。

• Better TOML 装完要重启 VS Code，否则 Cargo.toml 的高亮和校验不触发；特别注意 [dependencies] 下方空行不能少，否则插件可能误判为语法错误
• Crates 插件右下角会显示「Update available」，但点击后默认只更新 minor 版本；如需升到 breaking change 版本（如 tokio 1.x → 2.x），得手动改 Cargo.toml 并运行 cargo update -p tokio
• 当 Crates 显示「? locked」却无更新提示，说明 Cargo.lock 锁定了旧版，此时删掉 lock 文件再 cargo build，才能强制拉取最新兼容版本

真正卡住人的从来不是某个插件装没装，而是 rustup、MSVC、CodeLLDB 这三层工具链的 ABI 对齐——Windows 上任意一层用错架构（x86 vs x64）或混用 msvc/gnu，调试就会彻底失能，且错误信息极其模糊。动手前先跑 rustup show 和 cl.exe 确认双环境一致，比反复重装插件省三小时。