Clang-Tidy在VSCode中需手动启用并正确配置clang-tidy.path和compile_commands.json，否则不生效；检查范围通过clang-tidy.checks和headerFilterRegex控制，但不支持--fix自动修复。
Clang-Tidy 在 VSCode 中不会自动生效，必须显式启用并确保 compile_commands.json 可被正确读取，否则所有检查都只是“摆设”。
确认 clang-tidy 可执行文件已就位且路径正确
VSCode 的 C/C++ 扩展（ms-vscode.cpptools）依赖系统 PATH 或手动配置的 clang-tidy.path 才能找到工具。它不认别名、软链接或未加入 PATH 的本地安装路径。
- 在终端运行
which clang-tidy（Linux/macOS）或where clang-tidy（Windows），确认输出是真实可执行路径（如/usr/bin/clang-tidy、C:\Program Files\LLVM\bin\clang-tidy.exe） - 若用 Homebrew 安装 LLVM，注意默认路径可能是
/opt/homebrew/bin/clang-tidy（Apple Silicon）或/usr/local/bin/clang-tidy（Intel），需明确填入设置 - VSCode 设置中搜索
clang-tidy.path，填入绝对路径；留空则 fallback 到 PATH，但 PATH 错误时静默失败，无提示 - 不要填
clang-tidy-15或带版本号的变体——除非你明确只用那个版本，且.clang-tidy配置里也匹配了该版本语义
compile_commands.json 必须存在且位置准确
VSCode 的 C/C++ 扩展通过 compile_commands.json 推导每个文件的包含路径、宏定义和语言标准。没有它，clang-tidy 会因无法解析头文件或模板而大量误报或直接跳过检查。
- 对 CMake 项目：在构建目录（如
build/）运行cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..，生成后**把整个compile_commands.json文件复制到项目根目录**（VSCode 默认只从 workspace root 查找） - 不推荐用
-p build/参数让 VSCode 去子目录找——C/C++ 扩展不支持该参数透传，该配置项仅影响命令行调用 - 验证是否加载成功：打开任意
.cpp文件，按Ctrl+Shift+P→ 输入 “C/C++: Show References to Symbol at Cursor”，如果能跳转到系统头或第三方头，说明编译数据库已生效 - 非 CMake 项目（如 Makefile）可用
compdb或bear -- make生成，但 bear 有时漏宏定义，建议优先补全为 CMake
启用 clang-tidy 并控制检查范围
VSCode 默认禁用 clang-tidy，即使装了扩展也只跑微软原生分析器（MSVC/IntelliSense）。必须手动开启，并配合 headerFilterRegex 避免扫描第三方代码。
立即学习“C++免费学习笔记（深入）”；
- 在 VSCode 设置（
settings.json）中添加："clang-tidy.enabled": true, "clang-tidy.checks": [ "-*", "modernize-*", "cppcoreguidelines-*", "performance-*", "bugprone-*" ], "clang-tidy.headerFilterRegex": "^(include|src|app)"
-
clang-tidy.checks是字符串数组，不是单个字符串；通配符-*必须写在最前，否则默认检查仍会激活 -
headerFilterRegex控制哪些头文件参与检查——不设它会导致<vector>、<QtWidgets>等全部被扫，产生海量无关警告 - 若想禁用某条规则（如
cppcoreguidelines-owning-memory），直接在 checks 数组里加"-cppcoreguidelines-owning-memory"即可
自动修复（--fix）在 VSCode 中不可用
VSCode 的 C/C++ 扩展目前不支持 --fix 参数，编辑器内点击灯泡（?）只能跳转到问题位置或查看说明，不能一键重写代码。
- 需要自动修复，只能回到终端手动运行：
clang-tidy -p . --fix src/main.cpp - 修复后可能引入格式错乱（比如缩进、空格），建议紧接着跑一次
clang-format -i src/main.cpp - CI 流程中可安全使用
--fix+git diff --quiet检查是否修改，但本地开发慎用——尤其涉及auto推导或移动语义时，自动替换可能改变语义 - 真正容易被忽略的是：VSCode 编辑器内的波浪线警告来自 IntelliSense 引擎，和 clang-tidy 无关；只有“错误列表”（Problems panel）里标着 “clang-tidy” 的才是真实结果
