使用OpenCV+CUDA构建C++项目时遇LNK2001未解析外部符号错误

问题背景 #

在Windows 10 + Visual Studio 2022环境下，构建基于CUDA 11.6.2的OpenCV 3.4.20（已集成opencv_contrib模块）C++项目时，链接阶段出现如下错误：

LNK2001 unresolved external symbol "int __cdecl cv::countNonZero(class cv::debug_build_guard::_InputArray const &)" (?countNonZero@cv@@YAHAEBV_InputArray@debug_build_guard@1@@Z)

已知单独编译所有.cu和.cpp文件均成功，仅链接环节失败，且已确认所需库文件存在、函数声明定义完整。

解决方案 #

• 补充缺失的imgproc模块库
  cv::countNonZero属于OpenCV的imgproc模块，当前项目的附加依赖项中未包含对应库。需在AdditionalDependencies中添加：

  • Release模式：opencv_imgproc3420.lib
  • Debug模式：opencv_imgproc3420d.lib

• 确保配置与库版本严格匹配

  • 检查当前构建模式（Release/Debug）与链接的库后缀一致：Debug模式必须使用带d后缀的库，Release模式使用无后缀库，禁止混合引用。
  • 验证项目的平台配置为x64，与编译OpenCV时的平台一致。

• 确认OpenCV编译完整性

  • 重新检查CMake编译OpenCV时的配置，确保BUILD_opencv_imgproc选项已勾选，且编译过程无报错。
  • 核对C:\Users\RIT\opencv-3.4\build\install\x64\vc17\lib目录下是否存在opencv_imgproc3420.lib/opencv_imgproc3420d.lib文件。

• 排查路径与符号冲突

  • 确保项目IncludePath仅包含当前编译的OpenCV头文件路径，避免系统中其他OpenCV版本的头文件干扰。
  • 检查项目字符集配置：OpenCV默认使用多字节字符集，若项目设为Unicode字符集，需调整为一致，避免符号不匹配。

• 清理重建项目

  • 删除项目的Debug/Release输出目录，以及Visual Studio临时缓存文件（如%USERPROFILE%\AppData\Local\Microsoft\VisualStudio\17.0_*\ComponentModelCache）。
  • 执行项目清理操作后重新构建。

• 规避目录名称字符问题
  注意到Users目录下存在RIT和RİT（含特殊字符İ）两个目录，确保项目所有配置路径均指向RIT目录，避免因字符编码导致链接器无法定位库文件。

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