如何在VS2019+CMake环境下仅屏蔽第三方库文件的编译器警告

核心原因说明 #

• MSVC的/wd开关本身不支持按目录过滤警告，你尝试的/wd4244:路径语法是GCC/Clang专属，MSVC无法识别所以会触发编译错误。
• CMake的SYSTEM目录标记默认对MSVC不生效，因为MSVC没有原生的系统目录警告降级逻辑，需要额外配置编译器开关激活对应能力。

可行解决方案 #

方案1：CMake端统一配置（推荐）

不需要修改业务代码，只调整CMake规则即可全局生效：

1. 首先在CMakeLists.txt最顶部添加MSVC专属编译开关，开启外部目录警告抑制能力：

if (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
    # 开启MSVC的外部头文件警告过滤功能，将外部头文件警告等级设为最低
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /experimental:external /external:W0")
    # 让CMake的SYSTEM目录标记对应到MSVC的/external:I参数
    set(CMAKE_INCLUDE_SYSTEM_FLAG_CXX "/external:I ")
endif()

2. 所有第三方库的头文件目录，使用带SYSTEM属性的target_include_directories引入，不要用全局的include_directories：

# 替换为你实际的编译目标名、第三方头文件路径
target_include_directories(你的项目目标名 SYSTEM PRIVATE
    ${PROJECT_SOURCE_DIR}/ThirdParty
    ${Qt5_INCLUDE_DIRS}
    ${Protobuf_INCLUDE_DIRS}
    ${Lmx_INCLUDE_DIRS}
)

配置完成后重新生成编译文件，所有第三方目录下头文件产生的警告会被完全屏蔽，你自己编写的代码警告会保留你设置的/W4等级正常输出。

方案2：代码端局部处理

如果不方便调整CMake配置，可以在业务代码引入第三方头文件时用#pragma临时控制警告等级：

// 压入当前警告等级，临时设置为最低级屏蔽所有警告
#pragma warning(push, 0)
// 所有第三方头文件都放在这个区间内引入
#include <QObject>
#include <google/protobuf/message.h>
#include "lmx相关头文件.h"
// 恢复之前的警告等级
#pragma warning(pop)

这种方式只会屏蔽当前文件内引入的第三方头文件警告，适配性更强，但需要修改所有引入了第三方头文件的业务代码。

额外提示 #

你之前全局配置的/wd4244可以删除，上述方案已经单独屏蔽了第三方代码的所有警告，自有代码的C4244等警告会正常触发提示。
/experimental:external特性在VS2017 15.6及以上版本就已稳定支持，VS2019可以放心使用。

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