使用clang++与CMake构建简单CUDA程序遇到问题

基础配置前提 #

• 确保CMake版本≥3.18，这版本开始对Clang编译CUDA的支持更稳定
• 不用瞎折腾CMAKE_CUDA_COMPILER，配置时直接指定CMAKE_CXX_COMPILER=clang++，CMake会自动用这个Clang处理CUDA代码

关键变量要不要设？看情况 #

• CMAKE_CUDA_COMPILER：只有当你的Clang不在系统默认路径，或者需要指定特定版本（比如clang++-17）时，才手动加-DCMAKE_CUDA_COMPILER=clang++-17，否则完全不用管
• CUDA_IMPLICIT_LINK_DIRECTORIES：没必要手动指定，CMake会自动识别CUDA Toolkit的库路径。除非你把CUDA装在了非标准位置，那直接用-DCMAKE_CUDA_TOOLKIT_ROOT_DIR=/path/to/your/cuda让CMake自己检测就行

完整CMakeLists.txt示例 #

cmake_minimum_required(VERSION 3.18)
project(CudaWithClang LANGUAGES CXX CUDA)

# 设置适配你GPU的计算架构，比如sm_75对应RTX20系列，sm_80对应RTX30系列，自行查型号匹配值
set(CMAKE_CUDA_ARCHITECTURES 75)

# 直接把.cu文件加入可执行程序即可
add_executable(cuda_test main.cu)

# 一般CMake会自动链接cudart等必要库，除非用到特殊CUDA库，再手动添加target_link_libraries

配置编译命令 #

mkdir build && cd build
# 配置时指定Clang，以Release模式编译
cmake .. -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_BUILD_TYPE=Release
# 多线程编译加速
make -j$(nproc)

常见坑排查 #

• 找不到CUDA工具包：先跑nvcc --version确认CUDA已安装，未安装先补装；若已安装但CMake找不到，加-DCMAKE_CUDA_TOOLKIT_ROOT_DIR指定安装路径
• 架构不匹配报错：CMAKE_CUDA_ARCHITECTURES的数值要和你的GPU计算能力对应，查清楚自己GPU的型号再调整
• 链接时出现未定义符号：检查.cu文件里的核函数是否加了__global__修饰，或者是否误改了CMake的链接设置（正常情况下CMake会自动处理必要库的链接）

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