如何在CMake+Clang构建时检测未解析符号并终止构建？

问题原因 #

-Wl,-z,defs是链接器专属选项，但你把它放到了CMAKE_CXX_FLAGS中——这个变量会被CMake用于所有编译阶段的命令，包括那些仅编译不链接的检测程序（比如FindThreads模块生成的测试代码）。

Clang在仅编译模式下遇到链接器参数时，会触发-Wl,-z,defs: 'linker' input unused警告，而你开启了-Werror，这个警告会被转为错误，导致检测程序编译失败，最终CMake误判pthread.h不存在，抛出找不到Threads库的错误。

解决方案 #

核心思路是将链接器选项与编译选项分离，只在链接阶段传入-Wl,-z,defs：

方式1：全局设置链接器选项 #

把链接器选项放到专门的链接器变量中，而非编译变量：

# 编译阶段选项：仅保留编译相关的参数
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Werror -pthread")

# 给可执行文件设置链接选项
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,-z,defs")
# 给共享库设置链接选项（如果你的项目包含共享库）
set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -Wl,-z,defs")

方式2：目标级精准设置（推荐，CMake 3.13+） #

使用CMake的现代目标属性接口，更精准地控制每个目标的编译和链接选项，避免全局设置的副作用：

# 全局编译选项（可选，也可以给单个目标设置）
add_compile_options(-Werror -pthread)

# 全局链接选项，作用于所有后续创建的目标
add_link_options(-Wl,-z,defs)

# 或者针对单个目标单独设置
add_executable(MyApp main.cpp)
target_compile_options(MyApp PRIVATE -Werror -pthread)
target_link_options(MyApp PRIVATE -Wl,-z,defs)

这样设置后，CMake的检测程序在仅编译时不会收到链接器参数，不会触发Clang的警告；而在实际构建你的程序链接阶段，-Wl,-z,defs会生效，确保检测未解析符号。

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