从VS2022社区版切换到专业版后CUDA CMake构建失败如何解决

根因说明 #

CUDA SDK安装时会自动检测系统中已安装的Visual Studio实例，将CUDA编译所需的MSBuild扩展文件写入对应VS实例的专属目录。从社区版切换到专业版属于独立的VS实例，CUDA 11.6安装时没有向专业版的目录写入集成文件，CMake在调用VS生成器检测CUDA工具集时就会抛出该错误。
之前从VS2019升级到VS2022时重装CUDA能解决问题，本质就是重装过程触发了CUDA对新VS实例的检测和集成文件写入，不需要每次都全量卸载重装SDK。

按优先级尝试修复方案 #

• 方案1：修复CUDA安装（最快，无需手动改文件）

  1. 关闭所有Visual Studio和CMake进程
  2. 打开控制面板-程序和功能，找到已安装的CUDA 11.6，右键选择「更改」
  3. 在安装向导中选择「修复」选项，等待修复完成后重启系统
  4. 删除原有build目录下的CMakeCache.txt和CMakeFiles文件夹，重新执行CMake配置即可

• 方案2：手动补全MSBuild集成文件（100%生效，无需跑安装程序）

  1. 打开VS2022社区版残留的CUDA扩展目录，默认路径：
     C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Microsoft\VC\v170\BuildCustomizations
  2. 复制该目录下4个CUDA相关文件：CUDA 11.6.props、CUDA 11.6.targets、CUDA 11.6.xml、Nvda.Build.CudaTasks.v11.6.dll
  3. 打开VS2022专业版对应的BuildCustomizations目录，默认路径：
     C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\BuildCustomizations
  4. 将复制的4个文件粘贴到专业版对应目录，存在同名文件直接覆盖
  5. 清理CMake缓存后重新配置即可

• 方案3：单独重装VS集成组件（兜底方案）

  1. 在程序和功能中仅卸载CUDA组件下的CUDA Visual Studio Integration 11.6，不需要卸载其他CUDA编译、运行时组件
  2. 重新运行CUDA 11.6安装包，仅勾选刚才卸载的VS集成组件完成安装
  3. 重启后清理CMake缓存重新配置

注意事项 #

不要通过硬编码CMAKE_CUDA_COMPILER为nvcc.exe路径的方式绕过检测，该方法会跳过VS对CUDA工具集的版本匹配校验，后续混合编译、调试符号生成、版本适配都会出现隐性问题，没有解决故障根因。

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