CUDA CMake仅添加头文件构建库引发未定义引用错误的问询

你遇到的未定义引用错误核心原因非常直观：你的foo库实际上是空的——你只把foo.h这个汇总头文件添加到了库中，但头文件里只有类（比如Graph）和函数的声明，没有实际的实现代码（也就是函数体、类成员函数的定义）。

为什么会出现这个问题？ #

• 头文件的作用是告诉编译器「某个类/函数存在」，但实现代码（.cpp/.cu等源文件）才是真正包含可执行机器码的部分。
• 当你用cuda_add_library(foo foo.h)创建库时，CMake只会把这个头文件打包进去，但头文件本身不会被编译成二进制代码，所以你的foo库其实没有任何实际的函数实现。
• 等到链接foo_test的时候，编译器知道Graph::G...这个函数应该存在，但在foo库里找不到对应的实现，自然就抛出「未定义引用」错误。

怎么解决？ #

你需要把所有包含实现代码的源文件（比如Graph.cpp、utils.cu之类的）都添加到库的构建命令里：

# 把所有相关的源文件（.cpp/.cu）都加进来，而不只是头文件
cuda_add_library(foo 
    foo.h
    Graph.cpp
    utils.cu
    # 其他子目录里的源文件也需要列出来，或者用file(GLOB_RECURSE)批量引入（注意GLOB的利弊）
)

如果你的子目录里也有源文件，更规范的做法是给每个子目录单独写小型的CMakeLists.txt，然后用add_subdirectory()引入，比如：

# 根目录的CMakeLists.txt
cuda_add_library(foo foo.h)
add_subdirectory(graph)
add_subdirectory(utils)
# 把子目录的目标链接到foo库
target_link_libraries(foo PRIVATE graph_utils)

另外要注意：头文件不需要被添加到cuda_add_library的参数里也能被正确引用（只要你设置了target_include_directories让库的头文件路径可见），不过加进去也没问题，核心是必须包含所有实现类/函数的源文件。

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