Windows10下Qt5.8配置CUDA8.0遇未解析符号链接错误求助

我之前也踩过Qt搭配CUDA的链接坑，结合你的环境（Win10、VS2015 x64、Qt5.8、CUDA8.0），给你几个针对性的排查和解决方向：

1. 检查.pro文件的CUDA配置完整性 #

很多时候链接错误是因为.pro里的CUDA编译规则或路径配置不全，你可以对照以下示例调整：

# 指定CUDA安装路径
CUDA_DIR = "C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v8.0"

# 添加CUDA头文件路径
INCLUDEPATH += $$CUDA_DIR/include

# 链接CUDA核心库（x64版本）
LIBS += -L$$CUDA_DIR/lib/x64 \
        -lcudart \
        -lcublas \
        -lcurand

# 适配VS2015 x64的编译参数
QMAKE_CXXFLAGS += -DWIN32 -D_WINDOWS -DNDEBUG -DQT_NO_DEBUG
QMAKE_LFLAGS += /SUBSYSTEM:WINDOWS /MACHINE:X64

# 配置CUDA源文件（.cu）编译规则
CUDA_SOURCES += your_cuda_kernel.cu  # 替换成你的CUDA文件名
CUDA_OBJECTS_DIR = ./cuda_obj
cuda.commands = $$CUDA_DIR/bin/nvcc.exe -Xcompiler "/EHsc /W3 /nologo /MD" \
                -I$$CUDA_DIR/include -I$$INCLUDEPATH -c ${QMAKE_FILE_NAME} -o ${QMAKE_FILE_OUT}
cuda.dependency_type = TYPE_C
cuda.output = $$CUDA_OBJECTS_DIR/${QMAKE_FILE_BASE}_cuda.obj
cuda.input = CUDA_SOURCES
QMAKE_EXTRA_COMPILERS += cuda

注意：必须确保你安装的Qt是x64版本的Qt5.8 for VS2015，32位Qt和x64 CUDA库完全不兼容。

2. 确认链接库的路径和顺序 #

你提到复制了VS示例的库文件，要注意两个点：

• 必须选用CUDA8.0 lib/x64目录下的库，别误用到lib/Win32下的32位库；
• 链接顺序很关键：CUDA相关库要放在Qt自带库的后面，避免符号依赖冲突。比如不要把LIBS += -lcudart写在QT += core gui之前。

3. 排查CUDA函数的符号导出问题 #

未解析符号最常见的原因是C++名字修饰和CUDA编译符号不匹配，解决方法是：
在调用CUDA函数的C++头文件里，用extern "C"包裹函数声明：

extern "C" {
    // 声明你的CUDA函数
    void run_my_cuda_kernel();
}

同时确保.cu文件里的函数定义和声明完全对应，不要出现重载或名字拼写错误。

4. 验证Qt Creator的Kit配置 #

打开Qt Creator的「工具->选项->构建和运行」，检查当前使用的Kit：

• 编译器必须是MSVC 2015 64bit；
• Qt版本必须是x64架构的Qt5.8；
• 可以在Kit的「环境变量」里手动添加CUDA的bin路径：C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v8.0\bin，避免系统PATH缺失导致的链接问题。

5. 清理缓存后重新构建 #

旧的编译缓存经常会导致奇怪的链接错误，执行以下步骤：

1. 点击「构建->清理项目」；
2. 手动删除项目的构建目录（比如build-xxx-Desktop_Qt_5_8_0_MSVC2015_64bit-Release）；
3. 重新执行构建。

如果以上方法都无效，建议把未解析符号的具体内容贴出来（比如是CUDA runtime的符号还是你自定义的CUDA函数符号），这样能更精准定位问题。

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