如何让CMake提前检测静态C++库可用性并给出缺失警告？

一、让CMake在配置阶段提前检测静态库缺失 #

你的核心痛点是当前配置流程中，CMake只会在编译链接阶段才发现静态库缺失，导致前期白跑了配置步骤。我们可以通过两种方式让问题提前暴露：

1. 强制Threads包查找静态库 #

默认情况下CMake优先找动态库，我们可以临时修改库后缀规则，让find_package(Threads)只搜索静态版本，找不到就直接在cmake阶段报错：

cmake_minimum_required(VERSION 3.17)
project(test)
set(CMAKE_CXX_STANDARD 17)

# 保存默认的库后缀，避免影响后续其他查找
set(ORIGINAL_LIB_SUFFIXES ${CMAKE_FIND_LIBRARY_SUFFIXES})
# 强制查找静态库（.a后缀）
set(CMAKE_FIND_LIBRARY_SUFFIXES .a)
find_package(Threads REQUIRED)
# 恢复默认后缀
set(CMAKE_FIND_LIBRARY_SUFFIXES ${ORIGINAL_LIB_SUFFIXES})

# 启用静态链接
add_link_options(-static)

add_executable(test)
target_link_libraries(test PRIVATE Threads::Threads)
target_sources(test PRIVATE test.cpp)

这样如果系统没有libpthread.a，find_package(Threads REQUIRED)会直接终止配置流程，给出清晰的错误提示。

2. 全局验证静态链接可行性 #

如果要覆盖所有依赖（比如libstdc++、glibc）的静态库检测，可以用try_compile在配置阶段尝试编译一个最小的静态链接程序：

首先在项目目录下创建static_check.cpp：

int main() { return 0; }

然后在CMakeLists.txt中添加检测逻辑：

cmake_minimum_required(VERSION 3.17)
project(test)
set(CMAKE_CXX_STANDARD 17)

# 尝试编译静态链接的最小程序，验证所有必要静态库是否存在
try_compile(
    STATIC_LINKING_SUPPORTED
    ${CMAKE_BINARY_DIR}/static_link_check
    SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/static_check.cpp
    CMAKE_FLAGS "-DCMAKE_EXE_LINKER_FLAGS=-static"
    OUTPUT_VARIABLE LINK_CHECK_OUTPUT
)

if(NOT STATIC_LINKING_SUPPORTED)
    message(FATAL_ERROR "静态链接失败，缺失必要的静态库！错误信息:\n${LINK_CHECK_OUTPUT}\n在Fedora 31上请安装libstdc++-static和glibc-static")
endif()

add_link_options(-static)
find_package(Threads REQUIRED)

add_executable(test)
target_link_libraries(test PRIVATE Threads::Threads)
target_sources(test PRIVATE test.cpp)

这种方式能一次性检测所有静态依赖，任何缺失都会在配置阶段直接报错。

二、更友好的跨平台静态链接实现 #

针对你提到的平台相关代码问题，这里有几个更便携的方案：

1. 用CMake内置变量控制链接优先级 #

CMake提供CMAKE_LINK_SEARCH_START_STATIC和CMAKE_LINK_SEARCH_END_STATIC，让链接器优先查找静态库，同时可以针对不同编译器做适配：

cmake_minimum_required(VERSION 3.17)
project(test)
set(CMAKE_CXX_STANDARD 17)

# 让链接器优先搜索静态库
set(CMAKE_LINK_SEARCH_START_STATIC ON)
set(CMAKE_LINK_SEARCH_END_STATIC ON)

add_executable(test)
# 针对GCC/Clang，强制静态链接标准库
target_link_options(test PRIVATE
    $<$<OR:$<CXX_COMPILER_ID:GNU>,$<CXX_COMPILER_ID:Clang>>:-static-libgcc -static-libstdc++>
)
# 针对MSVC，静态链接运行时库
if(MSVC)
    set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /MT")
    set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /MTd")
endif()

target_link_libraries(test PRIVATE Threads::Threads)
target_sources(test PRIVATE test.cpp)

这种方式比硬编码-static更灵活，不会强制静态链接所有库（比如某些系统专有库可能只有动态版本），同时保证核心依赖静态链接。

2. 目标级别的条件化静态链接 #

避免全局设置静态链接选项，只针对单个目标配置，减少对其他目标的影响，同时用生成器表达式自动适配编译器：

cmake_minimum_required(VERSION 3.17)
project(test)
set(CMAKE_CXX_STANDARD 17)

add_executable(test)
# 仅对当前目标启用静态链接，自动适配不同编译器
target_link_options(test PRIVATE
    $<$<OR:$<CXX_COMPILER_ID:GNU>,$<CXX_COMPILER_ID:Clang>>:-static>
    $<$<CXX_COMPILER_ID:MSVC>:/MT>
)
target_link_libraries(test PRIVATE Threads::Threads)
target_sources(test PRIVATE test.cpp)

生成器表达式$<...>会在CMake生成构建文件时自动判断编译器类型，无需手动写平台分支代码。

3. 适配发行版的友好提示 #

如果想让错误提示更贴心，可以添加发行版检测，给出对应系统的安装命令：

if(UNIX AND NOT APPLE)
    # 检测Linux发行版
    if(EXISTS "/etc/fedora-release")
        set(DISTRO "Fedora")
    elseif(EXISTS "/etc/lsb-release")
        file(READ "/etc/lsb-release" LSB_RELEASE)
        string(REGEX MATCH "DISTRIB_ID=([^\n]+)" _ ${LSB_RELEASE})
        set(DISTRO "${CMAKE_MATCH_1}")
    endif()

    if(NOT STATIC_LINKING_SUPPORTED)
        if(DISTRO STREQUAL "Fedora")
            message(FATAL_ERROR "缺失静态库，请执行: sudo dnf install libstdc++-static glibc-static")
        elseif(DISTRO STREQUAL "Ubuntu")
            message(FATAL_ERROR "缺失静态库，请执行: sudo apt install libc6-dev-static libstdc++-dev")
        else()
            message(FATAL_ERROR "静态链接失败，请安装对应系统的静态标准库")
        endif()
    endif()
endif()

这样用户能直接拿到适配自己系统的安装指令，减少排查成本。

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