Windows下CMake CUDA静态库分离编译链接错误，Ubuntu无此问题

这个__cudaRegisterLinkedBinary相关的LNK2019错误我在Windows上折腾CUDA静态库时也碰到过，本质是Windows平台下CUDA静态库的编译没有正确处理runtime注册代码，或者主程序链接时没关联好必要的CUDA组件。结合你的项目结构，直接给你一套可落地的修复步骤：

1. 调整根目录CMakeLists.txt #

首先得确保CMake正确识别CUDA语言，并给静态库加上关键的编译属性：

cmake_minimum_required(VERSION 3.18 FATAL_ERROR)
# 明确指定项目支持CXX和CUDA语言
project(CUDASampleProject LANGUAGES CXX CUDA)

# 设置你的GPU对应的CUDA架构（比如75是Turing，86是Ampere，按需调整）
set(CMAKE_CUDA_ARCHITECTURES 75)

# 编译静态库
add_library(mylib STATIC src/mylib.cu)

# 关键设置：启用分离编译，确保CUDA的注册代码被打包进静态库
set_target_properties(mylib PROPERTIES
    CUDA_SEPARABLE_COMPILATION ON
    # 强制用静态CUDA runtime，避免Windows下动态依赖的额外问题
    CUDA_RUNTIME_LIBRARY Static
)

# 把src目录设为公共头目录，让test项目能找到mylib.h
target_include_directories(mylib PUBLIC src)

# 添加test子项目
add_subdirectory(test)

2. 修正test目录的CMakeLists.txt #

主程序这边要确保正确链接静态库和CUDA的核心库：

add_executable(test_app main.cpp)

# 链接我们的静态库
target_link_libraries(test_app PRIVATE mylib)

# Windows下有时需要显式链接CUDA库，避免漏链
target_link_libraries(test_app PRIVATE ${CUDA_LIBRARIES})

3. 几个额外的踩坑提醒 #

• 版本兼容性要匹配：确认你的CUDA Toolkit版本和Windows上的Visual Studio版本兼容（比如CUDA 11.7支持VS2019/2022），版本不搭很容易出各种奇怪的链接错误。
• 清理缓存重来：Windows下CMake的缓存经常留坑，建议把旧的build目录删干净，重新走构建流程：

  rmdir /s /q build
  mkdir build && cd build
  # 换成你用的VS版本，比如VS2019是"Visual Studio 16 2019"
  cmake .. -G "Visual Studio 17 2022" -A x64
  cmake --build . --config Release
  

• 检查头文件和核函数声明：确保mylib.h里正确声明了CUDA相关的函数，比如：

  // mylib.h
  #pragma once
  #include <cuda_runtime.h>
  
  // 声明要暴露给主程序的CUDA函数
  void run_my_cuda_kernel();
  

  对应的mylib.cu实现要匹配：

  // mylib.cu
  #include "mylib.h"
  
  __global__ void my_kernel() {
      // 你的核函数逻辑
  }
  
  void run_my_cuda_kernel() {
      my_kernel<<<1, 1>>>();
      cudaDeviceSynchronize();
  }
  

这么调整后，Windows上的链接错误应该就能解决了——核心就是让CMake正确处理CUDA静态库的分离编译，把必要的注册代码打包进静态库，同时主程序链接时不遗漏CUDA的核心组件。

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