Linux下使用MinGW编译时配置标准库路径的问题

问题根源 #

你遇到的uintptr_t声明冲突，是因为CMake在MinGW交叉编译时错误引入了主机Linux系统的头文件目录（/usr/include），和MinGW自身的目标平台头目录（/usr/x86_64-w64-mingw32/include）重复，导致基础类型声明冲突。

解决方法 #

1. 使用CMake交叉编译工具链文件（最规范方案） #

创建专门的MinGW工具链配置文件（比如mingw-toolchain.cmake），强制CMake全程使用MinGW的目标平台环境，彻底避免主机系统头文件干扰：

# mingw-toolchain.cmake 内容
set(CMAKE_SYSTEM_NAME Windows)
set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)
set(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres)

# 指定MinGW根目录，限制CMake仅在此目录下查找依赖
set(CMAKE_FIND_ROOT_PATH /usr/x86_64-w64-mingw32)
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

# 预设C++20标准
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

使用该工具链文件执行构建：

cmake -S . -B build-mingw -DCMAKE_TOOLCHAIN_FILE=mingw-toolchain.cmake

2. 直接修改CMakeLists.txt强制替换头目录 #

如果不想单独维护工具链文件，可在项目根目录的CMakeLists.txt最开头（project()命令之前）添加以下代码：

# 检测是否为MinGW交叉编译
if(CMAKE_CXX_COMPILER MATCHES "mingw")
    # 强制优先使用MinGW自身头目录
    set(CMAKE_CXX_FLAGS "-I/usr/x86_64-w64-mingw32/include ${CMAKE_CXX_FLAGS}")
    set(CMAKE_C_FLAGS "-I/usr/x86_64-w64-mingw32/include ${CMAKE_C_FLAGS}")
    # 清空CMake自动添加的主机系统头目录列表
    set(CMAKE_SYSTEM_INCLUDE_PATH "")
    set(CMAKE_INCLUDE_PATH "")
endif()

3. 适配TRY_COMPILE目标 #

如果项目中的TRY_COMPILE仍出现问题，需确保它继承MinGW的编译环境，可在TRY_COMPILE命令中传递对应的CMake参数：

try_compile(
    MY_COMPILE_RESULT
    ${CMAKE_BINARY_DIR}/try_compile_build
    SOURCES your_test_source.cpp
    CMAKE_FLAGS 
        "-DCMAKE_CXX_COMPILER=${CMAKE_CXX_COMPILER}"
        "-DCMAKE_CXX_FLAGS=${CMAKE_CXX_FLAGS}"
        "-DCMAKE_FIND_ROOT_PATH=${CMAKE_FIND_ROOT_PATH}"
    OUTPUT_VARIABLE COMPILE_LOG
)

4. 调整Boost库配置 #

确保CMake在MinGW目录下查找静态多线程版Boost：

set(Boost_ROOT /usr/x86_64-w64-mingw32)
set(Boost_USE_STATIC_LIBS ON)
set(Boost_USE_MULTITHREADED ON)
find_package(Boost REQUIRED COMPONENTS 你的Boost组件列表)

总结 #

优先使用工具链文件方案，这是CMake交叉编译的标准实践，能确保包括子目录、TRY_COMPILE在内的整个构建流程都严格遵循MinGW的目标平台环境，从根源解决头文件冲突问题。

内容的提问来源于stack exchange，提问作者Георгий Гуминов