GitLab Runner构建GPU版OpenCV时找不到cudev模块问题

针对Windows GitLab Shell Runner编译OpenCV GPU模块时提示缺少cudev的问题，可从以下几个方向排查解决：

• 确保Git子模块完整拉取
  本地环境的子模块已初始化，但CI环境默认不会递归拉取子模块。需在.gitlab-ci.yml中添加子模块同步步骤：

  before_script:
    - git submodule update --init --recursive
  

  也可在Runner注册时启用git_submodules选项，验证服务器上opencv_contrib/modules/cudev目录是否存在。

• 校验OPENCV_EXTRA_MODULES_PATH路径有效性
  Windows路径需使用\或转义的/，CMakeLists.txt中要确保路径基于CI工作目录正确设置：

  set(OPENCV_EXTRA_MODULES_PATH "${CMAKE_CURRENT_SOURCE_DIR}/deps/opencv_contrib/modules")
  

  在CI脚本中添加路径检查命令，确认目录存在：

  dir "deps/opencv_contrib/modules/cudev"
  

• 清理CMake缓存与构建目录
  Runner可能残留旧构建缓存，导致配置未更新。在CI编译步骤前添加清理操作：

  rmdir /s /q build
  mkdir build
  cd build
  cmake .. [你的编译参数]
  

• 强制启用CUDA与cudev模块编译
  在CMake命令中明确指定相关参数，确保cudev被纳入编译：

  cmake .. -DWITH_CUDA=ON -DOPENCV_EXTRA_MODULES_PATH=../deps/opencv_contrib/modules -DCUDA_ARCH_BIN=8.6 -DOPENCV_ENABLE_NONFREE=ON
  

  注意CUDA_ARCH_BIN需匹配服务器GPU的算力架构（如RTX 30/40系列为8.6）。

• 验证Runner环境变量继承
  Windows下Shell Runner可能未继承系统的CUDA环境变量，可在Runner的config.toml中配置：

  [[runners]]
    executor = "shell"
    shell = "powershell"
    environment = [
      "CUDA_PATH=C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.2",
      "PATH=%PATH%;C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.2/bin"
    ]
  

  或在CI脚本中手动设置环境变量后再执行编译。

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