使用CMake FetchContent时如何禁用第三方库的编译器警告？

你遇到的SYSTEM标志不生效的问题，本质是部分第三方库（比如raylib、Google Test）的CMake配置会自行设置包含目录或警告选项，覆盖了FetchContent的SYSTEM标记效果。不需要依赖库方修改，你可以通过以下几种方式在自己的项目中解决：

1. 手动将第三方库目标标记为SYSTEM #

FetchContent的SYSTEM标志有时无法正确将库的头文件目录标记为系统目录，你可以在FetchContent_MakeAvailable之后，手动修改目标的包含目录属性：

以raylib为例：

FetchContent_Declare(
        raylib
        GIT_REPOSITORY https://github.com/raysan5/raylib.git
        GIT_TAG 4.2.0
)
FetchContent_MakeAvailable(raylib)

# 获取raylib原有的包含目录
get_target_property(RAYLIB_INCLUDES raylib INTERFACE_INCLUDE_DIRECTORIES)
# 清空原有设置，重新以SYSTEM方式添加，屏蔽头文件警告
set_target_properties(raylib PROPERTIES INTERFACE_INCLUDE_DIRECTORIES "")
target_include_directories(raylib SYSTEM INTERFACE ${RAYLIB_INCLUDES})

Google Test的处理方式完全一致，只需把目标名换成gtest、gmock即可：

FetchContent_MakeAvailable(googletest)

# 处理gtest
get_target_property(GTEST_INCLUDES gtest INTERFACE_INCLUDE_DIRECTORIES)
set_target_properties(gtest PROPERTIES INTERFACE_INCLUDE_DIRECTORIES "")
target_include_directories(gtest SYSTEM INTERFACE ${GTEST_INCLUDES})

# 处理gmock
get_target_property(GMOCK_INCLUDES gmock INTERFACE_INCLUDE_DIRECTORIES)
set_target_properties(gmock PROPERTIES INTERFACE_INCLUDE_DIRECTORIES "")
target_include_directories(gmock SYSTEM INTERFACE ${GMOCK_INCLUDES})

2. 直接禁用第三方库的编译警告 #

如果第一种方法仍有残留警告，你可以强制让第三方库在编译时关闭所有警告，避免其代码触发你的-Werror：

FetchContent_MakeAvailable(raylib)
# 禁止raylib自身编译时产生任何警告
target_compile_options(raylib PRIVATE -w)

注意这里用PRIVATE，只会影响raylib库本身的编译，不会传递到你的项目代码中。

3. 全局过滤特定警告（可选） #

如果某些警告无法通过上述方式屏蔽，你可以针对自己的项目目标，添加忽略特定警告的选项，比如：

target_compile_options(your_project_target PRIVATE -Wno-unused-parameter -Wno-sign-compare)

这种方式适合处理少数顽固的、来自第三方库头文件的警告。

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