如何用CMake动态链接CUDA库？解决未解析外部符号报错

问题原因 #

1. Windows平台动态库符号导出规则：Windows下编译动态库（SHARED）时，函数必须显式声明为导出符号，否则不会被加入库的导出表，导致主程序链接时无法找到f。你当前代码仅用extern "C"保证C风格命名，但缺少Windows平台必需的导出标记。
2. CUDA Runtime同步缺失：即使符号问题解决，核函数print的执行是异步的，主程序调用f()后直接返回会导致程序提前退出，无法看到输出结果（非链接错误，但属于功能缺陷）。
3. CMake配置不够规范：手动添加--cudart shared等参数不够符合CMake的最佳实践，且不必要的分离编译配置可能增加复杂度。

解决方法 #

1. 修改头文件，添加跨平台导出/导入宏 #

修改header.cuh，添加适配Windows动态库的宏定义，自动切换导出/导入状态：

#include "stdio.h"
#include "cuda_runtime.h"
#include "device_launch_parameters.h"

// 定义动态库符号导出/导入宏
#ifdef CUDA_COMP_EXPORTS
#define CUDA_COMP_API __declspec(dllexport)
#else
#define CUDA_COMP_API __declspec(dllimport)
#endif

extern "C" CUDA_COMP_API void f();

2. 调整CUDA核函数实现文件 #

修改kernel.cu，用宏标记导出函数，并添加CUDA设备同步：

#include "header.cuh"

void __global__ print()
{
    int idx = blockIdx.x * blockDim.x + threadIdx.x;
    printf("%d\n", idx);
}

CUDA_COMP_API void f()
{
    print<<<1, 10>>>();
    cudaDeviceSynchronize(); // 等待核函数执行完成，避免程序提前退出
}

3. 优化CMake配置文件 #

替换原CMakeLists.txt为更规范的版本，让CMake自动处理CUDA相关配置：

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

# 启用CUDA语言支持（CMake 3.17+无需单独find_package(CUDA)）
enable_language(CUDA)
set(CMAKE_CUDA_STANDARD 14)

# 配置使用动态CUDA Runtime库（替代手动添加--cudart shared）
set(CMAKE_CUDA_RUNTIME_LIBRARY Shared)

# 编译动态库，定义导出宏
add_library(CUDA_COMP SHARED kernel.cu header.cuh)
target_compile_definitions(CUDA_COMP PRIVATE CUDA_COMP_EXPORTS)
set_property(TARGET CUDA_COMP PROPERTY CUDA_ARCHITECTURES 86)

# 编译主程序
add_executable(main main.cpp)

# 链接动态库，并传递CUDA头文件路径
target_link_libraries(main PRIVATE CUDA_COMP)
target_include_directories(main PRIVATE ${CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES})

关键修改说明 #

• 通过CUDA_COMP_EXPORTS宏自动切换__declspec(dllexport)/__declspec(dllimport)，确保库编译时导出符号，主程序编译时导入符号。
• 用CMAKE_CUDA_RUNTIME_LIBRARY Shared替代手动添加编译参数，更符合CMake的配置规范。
• 移除不必要的CUDA_SEPARABLE_COMPILATION和-rdc=true（当前示例无需分离编译设备代码），若后续需要跨文件调用核函数，再重新启用该配置。

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