clang-tidy检测IAR项目时已设过滤规则仍输出系统头文件错误如何解决

你遇到的报错属于clang-diagnostic-error类型，是Clang前端编译阶段抛出的语法/宏识别错误，不属于clang-tidy的自定义检查告警：

• -header-filter参数仅控制clang-tidy对哪些头文件运行自定义检查规则，不会过滤编译阶段的原生报错
• -isystem参数默认仅会抑制系统头文件的普通编译警告，不会屏蔽编译错误

可尝试以下解决方案：

1. 升级到clang-tidy 14及以上版本，直接在clang-tidy参数中添加--ignore-system-headers，该参数会彻底抑制所有系统头文件路径下的所有诊断输出，包括编译错误和clang-tidy检查告警。
2. 若无法升级版本，在命令末尾的编译选项（即--之后的部分）追加-Xclang -fdiagnostics-ignore-system，强制Clang前端忽略所有系统头文件中的诊断信息。
3. 若仍有漏网的报错，可在项目目录下添加.clang-tidy配置文件，加入规则批量屏蔽指定路径下的诊断：

CheckOptions:
  - key: clang-diagnostic-*
    value: suppress
    scope: "abs/path/to/SysHdrs/.*"

4. 从根源解决报错：你遇到的错误本质是Clang不识别IAR编译器专属的内置宏（__weak、__WEAK、__WCHAR_T_TYPE__等），可以在编译选项中手动定义这些宏，避免触发编译错误，示例如下：

-- -I"abs/path/to/Proj/Inc" -isystem"abs/path/to/SysHdrs" -D__weak=__attribute__((weak)) -D__WEAK=__attribute__((weak)) -D__WCHAR_T_TYPE__=wchar_t

5. 核对正则匹配规则：Windows下路径反斜杠需要双重转义，你的当前写法没有问题，如果需要兼容性更强的匹配规则，可将-header-filter修改为-header-filter=.*[/\\]Inc[/\\].*，兼容正/反斜杠的路径格式。

内容的提问来源于stack exchange，提问作者Alaa M.