NVCC编译报错‘_GLIBCXX_MATH_H未定义’问题排查与解决

这个问题我之前帮不少开发者排查过，在CUDA 9.0/9.1搭配GCC 5或6的环境下出现_GLIBCXX_MATH_H未定义的错误，核心原因大多和编译器版本匹配、头文件包含顺序或者nvcc的编译参数配置有关，下面给你详细拆解：

错误原因分析 #

• GCC版本不匹配：虽然CUDA 9.x官方支持GCC 5/6，但如果系统默认GCC是更高版本（比如7+），nvcc可能会意外调用不兼容的GCC头文件——_GLIBCXX_MATH_H是GNU libstdc++的内部宏，高版本GCC的头文件结构或宏定义逻辑和CUDA 9.x预期的不一致，导致宏缺失。
• 头文件包含顺序错误：如果在代码中先包含cuda_runtime.h这类CUDA头文件，再包含<cmath>等C标准头文件，会打乱libstdc内部宏的初始化顺序，使得_GLIBCXX_MATH_H无法被正确定义。
• nvcc编译参数配置错误：没有明确指定兼容的GCC路径，导致nvcc自动选择了系统中不兼容的编译器版本。

解决方法 #

1. 强制指定兼容的GCC版本 #

首先确认当前系统的GCC版本：

gcc --version

如果输出不是5或6，先安装对应版本：

# Debian/Ubuntu系统
sudo apt install gcc-5 g++-5
# RHEL/CentOS系统
sudo yum install gcc5 gcc-c++5

编译时通过-ccbin参数告诉nvcc使用指定的编译器：

nvcc -ccbin /usr/bin/gcc-5 your_program.cu -o your_program

也可以临时设置环境变量，避免每次编译都加参数：

export CC=/usr/bin/gcc-5
export CXX=/usr/bin/g++-5
nvcc your_program.cu -o your_program

2. 调整头文件包含顺序 #

确保代码中先包含C++标准头文件，再包含CUDA相关头文件，比如：

// 正确顺序
#include <cmath>
#include <cuda_runtime.h>

// 你的CUDA代码逻辑...

这样能保证libstdc++的内部宏在CUDA头文件加载前就完成初始化。

3. 临时 workaround：手动定义宏（不推荐长期使用） #

如果前两种方法暂时无法生效，可以尝试编译时手动定义_GLIBCXX_MATH_H宏，强制让编译器识别它：

nvcc -D_GLIBCXX_MATH_H your_program.cu -o your_program

注意：这是临时方案，因为手动定义libstdc++的内部宏可能引发其他未预期的编译问题，优先推荐前两种方法。

4. 检查并修正头文件搜索路径 #

可以通过nvcc -v查看编译时的头文件搜索路径：

nvcc -v your_program.cu

在输出中找到#include <...> search starts here:部分，确认是否包含了GCC 5/6对应的头文件目录（比如/usr/lib/gcc/x86_64-linux-gnu/5/include）。如果没有，用-I参数手动添加：

nvcc -I/usr/lib/gcc/x86_64-linux-gnu/5/include your_program.cu -o your_program

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