clang-tidy 不会自动生效，需配置可执行路径、检查规则及 compile_commands.json 编译上下文；先运行 clang-tidy --version 验证 path，再按 ide 要求指定全路径，确保 .clang-tidy 文件位于项目根目录且格式正确，最后确认 compile_commands.json 存在且有效。
Clang 安装完后，clang-tidy 不会自动生效——它需要明确指向可执行文件路径、配置检查规则、并确保能读到编译上下文（比如 compile_commands.json）。否则你在编辑器里看不到警告，命令行运行也报错或静默退出。
怎么确认 clang-tidy 已在 PATH 里
先验证是否真能调用，避免后续所有配置都白搭：
- 终端执行
clang-tidy --version，有输出版本号说明已就绪； - 如果提示
command not found，说明没加进PATH； - Linux/macOS：检查 LLVM 的
bin/目录（如/usr/local/opt/llvm/bin或~/llvm/bin）是否在$PATH开头； - Windows：确认 LLVM 安装路径（如
C:\Program Files\LLVM\bin）已添加到系统环境变量PATH，且重启了终端或 VSCode； - VSCode 中按
Ctrl+Shift+P→ 输入 “Developer: Toggle Developer Tools”，在 Console 里执行process.env.PATH，看路径是否包含 LLVM bin 目录。
CLion / VSCode / Visual Studio 怎么指定 clang-tidy 路径
IDE 默认可能用内置版本或根本找不到，必须显式配置：
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- CLion：Settings → Languages & Frameworks → C/C++ → Clang-Tidy → 勾选 Use external clang-tidy binary，然后填绝对路径，例如
/usr/local/opt/llvm/bin/clang-tidy（macOS）、C:\Program Files\LLVM\bin\clang-tidy.exe（Windows）； - VSCode：在
settings.json里加一行："clangd.arguments": ["--clang-tidy", "--clang-tidy-checks=modernize-*"]，或更稳妥地指定二进制："clangd.arguments": ["--clang-tidy-binary=/usr/local/opt/llvm/bin/clang-tidy"]； - Visual Studio：项目属性 → Code Analysis → Clang-Tidy → 勾选 Enable Clang-Tidy code analysis，再点下方 Clang-Tidy Settings，填入完整路径（注意不是目录，是
clang-tidy.exe文件本身）； - 关键点：路径必须是可执行文件的**全路径**，不能只写目录；Windows 上必须带
.exe后缀；路径中不能有空格或中文（否则某些 IDE 会静默失败）。
.clang-tidy 文件里 checks 怎么写才生效
.clang-tidy 是项目级规则中枢，但格式错一点就全失效：
- 必须放在项目根目录（即
compile_commands.json所在目录），否则 clang-tidy 可能读不到； - 内容格式严格：
Checks: '-*,cppcoreguidelines-*,modernize-*,-modernize-use-auto'—— 注意开头的-*表示禁用全部，后面再逐个启用； - 逗号前后**不能有空格**，否则部分工具（如旧版 clangd）会解析失败；
- 禁用某条规则用前缀
-，比如-cppcoreguidelines-pro-bounds-array-to-pointer-decay； - 想启用全部但排除几个，写成
Checks: '*, -llvm-header-guard, -google-readability-braces-around-statements'； - 修改后要重启 clangd 进程（VSCode 中 Ctrl+Shift+P → “Clangd: Restart”），否则缓存不刷新。
为什么 clang-tidy 没反应？最常卡在这三步
90% 的“配置完了没效果”问题，其实卡在底层依赖没跑通：
-
compile_commands.json缺失或路径不对：Clang-Tidy 必须靠它知道每个 .cpp 文件用什么参数编译。CMake 项目加-DCMAKE_EXPORT_COMPILE_COMMANDS=ON生成；Makefile 项目得用compiledb工具生成； - JSON 文件权限或编码错误：确保是 UTF-8 无 BOM，且文件可读（Linux/macOS 检查
ls -l compile_commands.json）； - 规则名拼错或已废弃：比如
readability-function-size在 clang 16+ 改叫readability-function-length，查最新文档用clang-tidy -list-checks确认可用项； - 额外提醒：Clang-Tidy 不分析未被
compile_commands.json覆盖的文件（比如临时新建的 .cpp），也不会处理头文件里的定义——除非该头文件被某个源文件 #include 且出现在 JSON 的 command 字段中。
真正麻烦的不是写规则，而是让 clang-tidy 看到你的编译上下文。路径、JSON、规则名，三者只要一个断链，整个静态检查就静默失效——这种问题没有报错，只有“什么都没发生”，最容易让人反复折腾半天还摸不着门。
