clang-tidy-17本地与GitHub Actions环境行为不一致问题排查

核心原因 #

两处环境的检查差异，本质是clang-tidy对MyType是否为可平凡复制类型的识别不一致：

• 本地环境中，clang-tidy能获取到MyType的完整定义，明确它是可平凡复制类型，因此：
  • 不会触发performance-unnecessary-value-param警告（对可平凡复制类型来说，传值后直接复制和std::move的开销完全相同，优化无意义）；
  • 若手动添加std::move，会触发performance-move-const-arg警告（std::move对可平凡复制类型没有实际效果）。
• GitHub Actions环境中，clang-tidy没有获取到MyType的完整类型信息，无法判断它是可平凡复制类型，因此会默认触发performance-unnecessary-value-param警告，认为可以通过std::move优化复制开销。

即使两处的clang-tidy版本、配置和编译器一致，只要编译上下文（头文件路径、宏定义、类型可见性）不同，就会导致AST分析结果差异，进而引发检查行为不一致。

解决步骤 #

1. 同步CI与本地的编译上下文 #

clang-tidy依赖完整的编译参数生成准确的AST，必须让CI中运行clang-tidy的命令包含与本地完全相同的编译选项：

• 复制本地编译时使用的头文件路径参数（如-I./include、-isystem /usr/local/include）；
• 同步所有宏定义参数（如-DMY_PROJECT_CONFIG=1）；
• 确保MyType所在的头文件在CI中能被正确找到和解析。

例如本地编译命令为：

g++ -std=c++17 -I./src/include -DMY_DEBUG main.cpp

CI中运行clang-tidy就要对应使用：

clang-tidy-17 -std=c++17 -I./src/include -DMY_DEBUG src/*.cpp --config-file=.clang-tidy

2. 强制指定clang-tidy配置文件路径 #

避免CI环境加载系统级或用户级的默认.clang-tidy配置，在命令中显式指定项目根目录的配置文件：

clang-tidy-17 [其他编译参数] --config-file=.clang-tidy

3. 静态断言验证MyType属性 #

在代码中添加静态断言，确保MyType在所有环境中都符合可平凡复制的定义，提前发现类型定义差异：

#include <type_traits>

static_assert(std::is_trivially_copyable_v<MyType>, "MyType must be trivially copyable");

如果CI环境中MyType的定义不符合，编译阶段就会直接报错，快速定位问题。

4. 排查全局配置干扰 #

检查CI环境是否存在全局clang-tidy配置文件（如~/.clang-tidy或/etc/clang-tidy/config），这些文件会覆盖项目本地配置。可在CI中执行以下命令对比配置：

clang-tidy-17 --dump-config

将输出与本地执行结果对比，确保配置完全一致。

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