CMake混合CUDA与C++项目出现cudart_static.lib重复定义链接错误

核心问题分析 #

你的问题源于两个关键冲突：

• 系统同时安装CUDA 11.8和12.2，新版本CMake可能自动拾取高版本工具链，与libtorch依赖的CUDA 11.8库产生版本不兼容
• CMake策略CMP0156（CUDA静态库链接行为）未设置，新版本CMake对CUDA库的链接逻辑与3.12时代差异较大，引发cudart_static.lib重复链接

具体解决步骤 #

1. 强制绑定CUDA 11.8工具链 #

在CMakeLists.txt最开头明确指定CUDA 11.8的编译器和根目录，避免CMake自动选择高版本：

# 指定CUDA 11.8编译器路径
set(CMAKE_CUDA_COMPILER "C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v11.8/bin/nvcc.exe")
# 或直接设置CUDA根目录
set(CUDA_TOOLKIT_ROOT_DIR "C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v11.8")

# 必须在project()命令前设置上述变量
project(YourProjectName LANGUAGES CXX CUDA)

2. 显式设置CMake策略CMP0156 #

CMP0156控制CUDA静态库的链接行为，新版本CMake默认会发出警告，显式设置可消除警告并统一链接逻辑：

# 在project()之后添加
cmake_policy(SET CMP0156 NEW)
# 若需完全兼容CMake 3.12的旧行为，可设置为OLD
# cmake_policy(SET CMP0156 OLD)

NEW模式下CMake会自动处理CUDA静态库的重复链接问题，避免手动引入时的冲突；OLD则沿用旧版链接逻辑。

3. 规范CUDA库的链接方式 #

避免手动添加cudart_static.lib，改用CMake官方的CUDAToolkit模块管理依赖：

find_package(CUDAToolkit 11.8 REQUIRED)
# 链接静态cudart库
target_link_libraries(YourTarget PRIVATE CUDAToolkit::cudart_static)

同时添加编译宏禁止自动链接CUDA运行时库，避免重复引入：

add_compile_definitions(CUDART_NO_AUTOMATIC_LINK)

4. 确保libtorch与CUDA版本严格匹配 #

确认你使用的libtorch是针对CUDA 11.8编译的版本，在CMake中显式指定libtorch路径：

set(Torch_DIR "path/to/libtorch-cu118/share/cmake/Torch")
find_package(Torch REQUIRED)
target_link_libraries(YourTarget PRIVATE ${TORCH_LIBRARIES})

可通过打印TORCH_VERSION变量验证版本：message(STATUS "Torch version: ${TORCH_VERSION}")，确保输出为2.0.1+cu118。

5. 清理构建缓存并重新生成 #

删除项目的build目录，彻底清除旧缓存带来的版本冲突，再重新执行构建：

# 删除build目录
rmdir /s /q build
# 重新生成配置文件
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
# 执行构建
cmake --build build --config Release

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