Sublime构建系统本身不支持静态检查与修复，必须依赖clang-tidy等外部工具通过shell_cmd调用实现；它仅执行命令并显示输出，无法解析AST或自动修改源码。
Sublime 的构建系统本身不支持静态检查与修复，必须靠外部工具（如 clang++ -fsyntax-only、clang-tidy、cppcheck）配合 shell_cmd 调用实现；直接在 C++.sublime-build 里写编译命令只能报错，不能自动修复。
为什么构建系统不能直接做“修复”
构建系统本质是执行命令行指令并捕获输出，它没有解析 AST、定位语法节点、生成补丁的能力。所谓“修复”必须由专用静态分析工具完成，比如 clang-tidy 的 -fix 参数或 clang-format 的重写能力——这些动作得在构建系统之外单独配置。
- 构建系统只负责“运行命令 + 显示 stdout/stderr”，错误高亮靠
file_regex匹配行号，但不会改源码 -
clang++ -fsyntax-only只能检查语法/语义错误，不提供修复建议 - 真正带修复能力的工具（如
clang-tidy -fix）需额外安装、路径正确、且命令中显式启用-fix
用 clang-tidy 实现检查 + 自动修复
这是目前 Sublime 中最接近“边检边修”的方案，但需手动触发（不能集成进默认 Ctrl+B），且依赖项目有 compile_commands.json。
- 先确保
clang-tidy已安装：终端运行clang-tidy --version有输出（macOS 用brew install llvm，Windows 从 LLVM 官网下载完整包） - 构建系统文件（如
Clang-Tidy.sublime-build）内容应为："shell_cmd": "clang-tidy -p "${project_path:.}" "${file}" -fix -quiet" -
-p指向编译数据库目录，不是单个 .cpp 文件；没compile_commands.json会报错error: no compile command found - 修复仅作用于当前文件，且部分规则（如
modernize-loop-convert）可能因上下文缺失而跳过
把 clang-format 当“轻量修复器”用
虽然不算严格意义的静态检查，但 clang-format 能修正格式类问题（空格、缩进、括号风格），且可绑定保存事件，体验接近自动修复。
- 必须在插件 Settings–User 中设
"format_on_save": true和"style": "File" -
.clang-format文件要放在项目根目录，且 YAML 缩进全为空格（tab 会导致静默失效） - 不要指望它修逻辑错误（比如
if (x = 1)），它只管格式；想查这类问题得上clang-tidy或-Wall -Wextra - Windows 用户注意 binary 路径必须带
.exe后缀，例如"binary": "C:\Program Files\LLVM\bin\clang-format.exe"
常见失败点：PATH、工作目录、权限
90% 的“命令未找到”或“修复不生效”不是配置写错了，而是环境没对齐。
- GUI 启动的 Sublime（双击图标）通常不继承终端的
~/.zshrc或PATH，macOS/Linux 用户要用终端启动：open -a "Sublime Text" --args - Windows 下若用快捷方式启动，PATH 必须是系统级环境变量，用户级 PATH 不生效
- 构建系统中
"working_dir": "${project_path}"比"${file_path}"更可靠，尤其当compile_commands.json在项目顶层时 -
clang-tidy -fix修改文件是直接覆写，如果文件被其他程序占用（如 IDE 锁定），会静默失败，无提示
真正难的不是写几行 JSON，而是让 clang-tidy 找到正确的编译上下文、让 clang-format 读到合法的 YAML、让 GUI Sublime 看见你终端里能跑通的命令——这三件事各自独立，又必须同时成立。
