如何屏蔽NVCC在CUDA+Google Test编译中的未引用函数误报警告？

我之前也踩过这个坑！当你用NVCC编译包含Google Test（GTest）的CUDA程序时，会碰到完全没必要的function <name> was declared but never referenced警告，明明代码逻辑没问题却弹出报错，就像你给出的这个最小复现示例：

// test.cu
#include <gtest/gtest.h>
namespace {
__global__ void a_kernel() {
    printf("Works");
}
TEST(ExampleTest, ExampleTestCase) {
    a_kernel<<<1, 1>>>();
}
}

用这个命令编译时：

nvcc test.cu -lgtest -lgtest_main

就会触发那个长长的、指向GTest生成的测试类方法的警告，属实烦人。

为什么会出现这个警告？ #

这其实是NVCC编译器的误报。GTest的TEST宏会自动生成一个继承自testing::Test的类，而NVCC的前端在处理宏生成的模板代码时，没能正确识别到这个类的实例其实是被GTest的运行时框架悄悄引用了，所以错误地判定相关函数未被使用。

几个可行的解决办法 #

1. 直接屏蔽特定警告 #

最简单的办法就是在编译时添加参数，关闭这个误报对应的警告：

nvcc test.cu -lgtest -lgtest_main -Wno-unused-function

不过要注意：这个参数会关闭所有"未使用函数"的警告，如果你自己的代码里真的有未使用的冗余函数，这个警告也会被掩盖，所以只建议在确定是误报的场景下用。

2. 分离CUDA代码和测试代码 #

把CUDA核函数和测试代码拆成两个文件，分别用NVCC和GCC/Clang编译，就能绕开这个兼容性问题：

• 新建kernel.cu，存放CUDA相关代码并封装主机端调用接口：

__global__ void a_kernel() {
    printf("Works");
}

// 给测试代码提供一个主机端调用入口
void run_a_kernel() {
    a_kernel<<<1, 1>>>();
}

• 新建test.cpp，纯C++的测试代码：

#include <gtest/gtest.h>
// 声明CUDA代码的调用接口
extern void run_a_kernel();

TEST(ExampleTest, ExampleTestCase) {
    run_a_kernel();
}

• 编译命令：

# 先编译CUDA代码为目标文件
nvcc -c kernel.cu -o kernel.o
# 再用GCC编译测试代码并链接CUDA目标文件和GTest库
g++ test.cpp kernel.o -lgtest -lgtest_main -L/usr/local/cuda/lib64 -lcudart

3. 升级你的CUDA Toolkit版本 #

NVIDIA在后续的CUDA版本中修复了这个和GTest宏交互的bug，如果你用的是比较旧的CUDA版本，直接升级到最新的稳定版，大概率就能自动解决这个问题。

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