使用Ninja生成器时，MSVC环境下CMake配置CUDA失败

问题情况 #

• 环境：VS2019搭配CUDA 11.3
• 现象：使用Ninja生成器编译时触发链接错误，切换为VS生成器可正常工作
• 触发节点：CMake执行enable_language(CUDA)，调用nvcc获取编译器版本的阶段出错

具体错误日志 #

libucrt.lib(checkcfg.obj) : error LNK2001: unresolved external symbol _guard_check_icall_$fo$
a.exe : fatal error LNK1120: 1 unresolved externals

已尝试的无效操作 #

• 卸载其他CUDA版本，重装11.3后重启系统
• 使用指定的Windows.MSVC.toolchain.cmake工具链

可行解决方案 #

1. 禁用Control Flow Guard（CFG） #

在CMake配置中添加参数，强制关闭CFG——这是引发符号未定义的核心原因：

# 给CUDA编译禁用CFG
set(CMAKE_CUDA_FLAGS "${CMAKE_CUDA_FLAGS} -Xcompiler /guard:cf-")
# 如果宿主代码也出现同类问题，同步关闭C/C++的CFG
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /guard:cf-")
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} /guard:cf-")

2. 明确指定兼容的MSVC工具链版本 #

CUDA11.3仅支持VS2019的v142工具链，在CMake中强制指定：

cmake_minimum_required(VERSION 3.20) # CUDA11.3建议使用3.18及以上版本的CMake
project(你的项目名 LANGUAGES CXX CUDA)

# 强制使用v142工具链
set(CMAKE_GENERATOR_TOOLSET "v142" CACHE STRING "MSVC工具链版本")

3. 通过VS命令行启动CMake #

确保Ninja使用VS2019兼容的环境：

1. 打开VS2019的「x64 Native Tools Command Prompt」（对应你需要的编译架构）
2. 在该命令行中执行CMake配置命令：

cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -S . -B build

问题原因 #

这个错误本质是CUDA11.3的nvcc与VS2019默认开启的Control Flow Guard（CFG）特性不兼容。nvcc在编译版本检测用的临时代码时，无法正确链接CFG相关的库符号。VS生成器会自动处理这类工具链兼容性细节，但Ninja生成器需要手动配置参数来规避冲突。

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