如何修改CMakeLists.txt实现Windows/Linux下MinGW库与头文件被编译器自动识别

我有一个计划发布为静态库的C项目，通过CMakeLists.txt构建并安装库及头文件。该配置在Linux下运行正常，但在Windows下，CMake会将文件安装到/usr/local/lib和/usr/local/include（对应路径为C:\msys64\usr\local\lib和C:\msys64\usr\local\include），而MinGW的GCC默认不会搜索这些路径，导致在C文件中使用#include <primes.h>时提示头文件未找到。

推测问题在于CMake默认使用的路径并非MinGW实际的库与头文件路径（如C:\msys64\mingw64\usr\lib和C:\msys64\mingw64\usr\include），且可能存在环境差异。请问如何修改CMakeLists.txt，实现Windows与Linux下开箱即用（OOB）的跨平台支持？

当前CMakeLists.txt代码：

cmake_minimum_required(VERSION 3.10)
project(libprimes VERSION 1.0.1)

set(CMAKE_C_STANDARD 99)
set(CMAKE_C_STANDARD_REQUIRED ON)
set(CMAKE_C_FLAGS_RELEASE "-O2 -g -DNDEBUG -Os")
set(CMAKE_C_FLAGS_DEBUG "-g -O0 -ggdb -Wall -Wextra -pedantic")

option(BUILD_TESTS "Build tests" ON)

add_library(primes STATIC src/primes.c src/sieve.c)
target_include_directories(primes PUBLIC "${CMAKE_SOURCE_DIR}/include")
target_link_libraries(primes PRIVATE pthread m)

install(TARGETS primes DESTINATION lib)
install(FILES include/primes.h DESTINATION include)

if(BUILD_TESTS)
    enable_testing()
    add_subdirectory(tests)
endif()

target_compile_options(primes PRIVATE -Wall -Wextra)

是否存在我所忽略的、通过CMake在Windows下安装C静态库的标准方式？

解决方案 #

1. 自动适配MinGW的安装路径 #

CMake的CMAKE_INSTALL_PREFIX变量控制默认安装根目录，在MinGW环境下，我们可以让它自动指向MinGW的标准路径，而非msys的/usr/local。在CMakeLists开头添加条件判断：

# 针对MinGW环境设置默认安装路径
if(MINGW)
    # 优先使用环境变量MINGW_PREFIX，没有则自动适配32/64位路径
    if(DEFINED ENV{MINGW_PREFIX})
        set(CMAKE_INSTALL_PREFIX "$ENV{MINGW_PREFIX}" CACHE PATH "Install path prefix" FORCE)
    else()
        if(CMAKE_SIZEOF_VOID_P EQUAL 8)
            set(CMAKE_INSTALL_PREFIX "C:/msys64/mingw64" CACHE PATH "Install path prefix" FORCE)
        else()
            set(CMAKE_INSTALL_PREFIX "C:/msys64/mingw32" CACHE PATH "Install path prefix" FORCE)
        endif()
    endif()
endif()

这样安装后，库会被放到mingw64/lib，头文件到mingw64/include，正好是MinGW GCC默认搜索的路径。

2. 跨平台链接库处理 #

Windows下不存在pthread和m（数学库），需要添加条件判断，仅在类Unix系统链接这些库：

# 仅在类Unix系统链接pthread和m库
if(UNIX)
    target_link_libraries(primes PRIVATE pthread m)
endif()

3. 优化编译选项的跨平台兼容性 #

替换原有的全局编译选项设置，改用目标专属的配置区分方式，更符合CMake现代用法：

# 按配置区分的目标专属编译选项
target_compile_options(primes PRIVATE
    -Wall -Wextra
    $<$<CONFIG:Debug>:-g -O0 -ggdb -pedantic>
    $<$<CONFIG:Release>:-O2 -g -DNDEBUG -Os>
)

完整修改后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.10)
project(libprimes VERSION 1.0.1)

# 针对MinGW环境设置默认安装路径
if(MINGW)
    if(DEFINED ENV{MINGW_PREFIX})
        set(CMAKE_INSTALL_PREFIX "$ENV{MINGW_PREFIX}" CACHE PATH "Install path prefix" FORCE)
    else()
        if(CMAKE_SIZEOF_VOID_P EQUAL 8)
            set(CMAKE_INSTALL_PREFIX "C:/msys64/mingw64" CACHE PATH "Install path prefix" FORCE)
        else()
            set(CMAKE_INSTALL_PREFIX "C:/msys64/mingw32" CACHE PATH "Install path prefix" FORCE)
        endif()
    endif()
endif()

set(CMAKE_C_STANDARD 99)
set(CMAKE_C_STANDARD_REQUIRED ON)

option(BUILD_TESTS "Build tests" ON)

add_library(primes STATIC src/primes.c src/sieve.c)
target_include_directories(primes PUBLIC "${CMAKE_SOURCE_DIR}/include")

# 仅在类Unix系统链接pthread和m库
if(UNIX)
    target_link_libraries(primes PRIVATE pthread m)
endif()

# 按配置区分的目标专属编译选项
target_compile_options(primes PRIVATE
    -Wall -Wextra
    $<$<CONFIG:Debug>:-g -O0 -ggdb -pedantic>
    $<$<CONFIG:Release>:-O2 -g -DNDEBUG -Os>
)

install(TARGETS primes DESTINATION lib)
install(FILES include/primes.h DESTINATION include)

if(BUILD_TESTS)
    enable_testing()
    add_subdirectory(tests)
endif()

关于Windows下CMake安装静态库的标准方式 #

当然存在标准方式：核心是利用CMake的系统检测变量（如MINGW、UNIX）和默认路径变量（CMAKE_INSTALL_PREFIX）做跨平台适配，让安装路径符合目标平台的标准规范。MinGW作为Windows上的类Unix环境，它的标准库/头文件路径就是mingwXX/lib和mingwXX/include，通过设置CMAKE_INSTALL_PREFIX指向MinGW根目录，就能让安装文件自动落入正确位置。

你也可以在运行CMake时手动指定安装路径，比如：

cmake .. -DCMAKE_INSTALL_PREFIX=C:/msys64/mingw64

但通过CMakeLists自动适配能实现开箱即用，更方便。

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