Windows下CMake+vcpkg项目编译报错：std::thread::id运算符不匹配

核心原因 #

Windows平台中，MSVC编译器的std::thread::native_handle_type为HANDLE类型，而apriltag依赖的pthread库期望线程句柄是pthread_t类型。你的项目在Gradle环境能正常构建，大概率是Gradle默认配置了MinGW工具链（以pthread作为线程实现），但当前CMake+vcpkg环境采用了MSVC的Win32线程模型，导致类型不匹配触发编译错误。

分步解决方法 #

1. 切换vcpkg Triplet到MinGW系列 #

默认x64-windows Triplet用MSVC工具链+Win32线程，需切换到支持pthread的MinGW Triplet：

• 安装apriltag时指定Triplet：

  vcpkg install apriltag:x64-mingw-static
  # 或动态版本
  vcpkg install apriltag:x64-mingw-dynamic
  

• CMake配置时指定工具链与Triplet：

  cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=C:/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-mingw-static -DCMAKE_CXX_COMPILER=g++
  

2. 调整CMakeLists.txt的线程配置 #

在CMakeLists.txt中明确指定优先使用pthread，确保线程库正确链接：

cmake_minimum_required(VERSION 3.20)
project(your_project_name)

# 优先使用pthread
set(CMAKE_THREAD_PREFER_PTHREAD ON)
set(THREADS_PREFER_PTHREAD_FLAG ON)
find_package(Threads REQUIRED)

# 查找apriltag依赖
find_package(apriltag CONFIG REQUIRED)

add_executable(your_target src/main.cpp)
target_link_libraries(your_target PRIVATE apriltag::apriltag Threads::Threads)

3. 手动适配apriltag代码（可选） #

若上述方法无效，可能是apriltag源码中直接对std::thread::native_handle()做==比较，需针对Windows平台修改：

找到apriltag中涉及线程句柄比较的代码，将handle1 == handle2替换为：

#ifdef _WIN32
CompareObjectHandles(handle1, handle2) == TRUE
#else
handle1 == handle2
#endif

之后重新通过vcpkg编译修改后的apriltag本地版本。

附件信息整理 #

CMake配置日志 #

# 粘贴你的CMake配置日志内容

编译错误信息 #

# 粘贴编译错误内容，核心错误示例：
error: no match for 'operator==' (operand types are 'std::thread::native_handle_type' {aka 'void*'} and 'std::thread::native_handle_type' {aka 'void*'})

CMakeLists.txt #

# 粘贴你的CMakeLists.txt内容

vcpkg.json #

{
  "name": "your-project",
  "version-string": "0.1.0",
  "dependencies": [
    "apriltag"
  ]
}

项目结构 #

your-project/
├── src/
│   └── main.cpp
├── CMakeLists.txt
└── vcpkg.json

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