cargo check 更适合保存时触发，因其仅做语义分析、跳过代码生成与链接，速度快且专为错误反馈设计；而 cargo build 会生成二进制，慢且不必要。
为什么 cargo check 比 cargo build 更适合保存时触发
保存即编译不是为了生成可执行文件，而是快速反馈语法和类型错误。用 cargo build 会链接、生成二进制，慢且不必要；cargo check 只做语义分析，跳过代码生成，快得多，也更贴近编辑器实时检查的定位。
常见错误现象：配置成 cargo build 后，每次保存卡顿 2–5 秒，还常因依赖未就绪报错 error: could not compile `xxx`，误以为配置失败。
-
cargo check默认不检查测试模块（#[cfg(test)]），如需覆盖，加--all-targets - 若项目含
build.rs，cargo check仍会运行它——这点容易被忽略，可能引入意外耗时 - VSCode 的 Rust 插件（rust-analyzer）默认已启用后台
cargo check，手动配置保存任务前先确认是否重复触发
用 Tasks 配置保存时自动运行 cargo check
VSCode 的 task 不是“监听保存”，而是通过“保存时运行 task”这一扩展能力实现。核心靠 tasks.json 中的 isBackground 和问题匹配器（problem matcher）配合。
实操建议：
- 在项目根目录创建
.vscode/tasks.json，内容以version:"2.0.0"开头 - task 的
label必须为"cargo check"（rust-analyzer 会识别该 label 并复用其输出） - 必须指定
"problemMatcher": "$rust"，否则错误不会出现在 Problems 面板 - 命令行参数推荐：
["check", "--message-format=json", "--all-features"]——--message-format=json是 rust-analyzer 解析错误的关键
示例片段：
{
"version": "2.0.0",
"tasks": [
{
"label": "cargo check",
"type": "shell",
"command": "cargo",
"args": ["check", "--message-format=json", "--all-features"],
"group": "build",
"isBackground": true,
"problemMatcher": "$rust"
}
]
}
绑定保存动作：用 saveBeforeRun 还是扩展？
VSCode 原生不支持“保存即运行 task”，得靠扩展或设置间接实现。最稳的方式是安装 Wallaby.js 类思路的通用扩展——但 Rust 场景下，直接用 rust-analyzer 自带的 rust-analyzer.checkOnSave.enable 更轻量、无冲突。
操作路径：Settings → Extensions → rust-analyzer → Check On Save → Enable，对应配置项是 "rust-analyzer.checkOnSave.enable": true。
- 该选项本质就是调用
cargo check --message-format=json，与手动 task 完全一致，无需重复配置 - 若同时启用了 task + 此选项，会看到两次检查日志，但只有一次结果展示（rust-analyzer 会去重）
- Windows 用户注意：PowerShell 默认禁用脚本执行，若看到
File xxx.ps1 cannot be loaded，需临时改执行策略，或改用 Command Prompt 终端
错误不显示？重点查这三处
配置完发现 Problems 面板空空如也，不是没运行，而是输出没被识别。90% 是以下三个点之一出问题：
-
cargo不在 PATH 中：在 VSCode 内置终端运行which cargo（macOS/Linux）或where cargo（Windows），确认路径；若用 rustup，确保 shell 初始化了~/.cargo/env - 项目不是 Cargo 工作区根目录：VSCode 打开的是子目录（如
my-project/crates/utils），cargo check会失败并静默退出；应打开包含Cargo.toml的顶层目录 -
rust-analyzer正在加载中：右下角状态栏显示 “Loading…” 时，检查功能被挂起；可看 Output 面板切换到 “rust-analyzer” 查看进度
复杂点在于：Cargo 的 JSON 输出格式对换行和编码敏感，任何非 UTF-8 字符（比如中文注释里的不可见符号）都可能导致解析中断，错误消失却不报错——这时得开 Output 面板看原始输出流。
