clang-tidy扫描文件夹仅提示编译错误无详情，如何排查？

当clang-tidy只输出提示信息却不显示具体错误、也不生成日志时，按以下步骤排查：

• 开启verbose模式查看编译细节
  运行clang-tidy时添加-v参数，会输出完整的编译过程日志，能直接看到底层编译阶段触发的错误（比如头文件缺失、语法错误、宏定义问题等），命令示例：

  clang-tidy -v your_source.cpp
  

• 确认编译数据库配置正确
  clang-tidy依赖compile_commands.json获取编译参数：

  • 若为CMake项目，生成构建文件时需添加-DCMAKE_EXPORT_COMPILE_COMMANDS=ON，确保该文件生成在构建目录中；
  • 非CMake项目，需手动生成或指定编译数据库路径，用-p参数指定目录，示例：

    clang-tidy -p ./build_dir your_source.cpp
    

• 强制显示所有非系统头文件错误
  按照提示添加-header-filter=.*参数，关闭默认的头文件过滤规则，让clang-tidy输出所有非系统头文件的错误信息，命令示例：

  clang-tidy -header-filter=.* your_source.cpp
  

  若怀疑系统头文件有问题，再加-system-headers参数。

• 单独用clang编译目标文件验证
  把clang-tidy要分析的源文件单独用clang编译，直接排查编译层面的问题，示例：

  clang -c your_source.cpp -I./include -DDEFINE_MACRO
  

  这里要带上项目实际需要的编译参数（头文件路径、宏定义等），能快速定位是文件语法错误还是编译参数缺失。

• 检查clang-tidy与clang版本兼容性
  确保clang-tidy和clang的版本一致，版本不匹配可能导致编译参数解析失败，进而无法输出详细错误。

内容的提问来源于stack exchange，提问作者kstn