VS Code下gcc编译C程序报错找不到Python.h头文件排查

你遇到的编译错误由四类典型配置错误导致：

• gcc的-I参数仅接受确切的目录路径，既不支持**这类递归通配符，也不会自动递归遍历指定目录下的子目录搜索头文件。你写的-I/usr/include/**属于无效参数，且/usr/include本身就是gcc默认搜索的头文件根目录，根本不需要额外添加。
• 路径中的~符号不会被VS Code的任务执行器自动展开为家目录路径，gcc拿到的是字面量字符串~/anaconda3/...，对应路径实际不存在，自然找不到Python.h。
• 你对依赖头文件的存放位置存在误判：glib.h并不在/usr/include根目录下，默认存放在/usr/include/glib-2.0子目录中；numpy的arrayobject.h对应的头文件路径你多写了一层/numpy后缀，路径指向错误。
• 当前编译参数只添加了头文件搜索路径，没有添加对应依赖库的链接参数，就算解决了头文件找不到的问题，后续也会触发符号未定义的链接错误。

• 先确认本地所有依赖头文件的真实路径，在终端执行以下命令，禁止靠猜测写路径：

  # 查看自己的家目录绝对路径，后续替换配置里的~
  echo $HOME
  # 确认Python.h存在
  ls $HOME/anaconda3/envs/myenv/include/python3.9/Python.h
  # 确认numpy的arrayobject.h存在
  ls $HOME/anaconda3/envs/myenv/lib/python3.9/site-packages/numpy/core/include/numpy/arrayobject.h
  # 查找glib.h的实际存放位置
  sudo find /usr/include -name "glib.h"
  

  通常64位Linux系统下，glib除了/usr/include/glib-2.0目录外，还需要添加/usr/lib/x86_64-linux-gnu/glib-2.0/include路径，该目录存放glib的平台相关配置头文件。

• 修改tasks.json中的编译参数，删掉无效的通配符路径，替换为真实的绝对路径，同时补上必要的链接参数，参考配置如下：

  "args": [
      "-fdiagnostics-color=always",
      // 替换为你自己echo $HOME输出的家目录路径，禁止使用~
      "-I/home/your_name/anaconda3/envs/myenv/include/python3.9",
      // numpy头文件路径，去掉多余的/numpy后缀
      "-I/home/your_name/anaconda3/envs/myenv/lib/python3.9/site-packages/numpy/core/include",
      // glib头文件路径，和find命令查到的结果保持一致
      "-I/usr/include/glib-2.0",
      "-I/usr/lib/x86_64-linux-gnu/glib-2.0/include",
      "-g",
      "${file}",
      // 链接依赖库参数
      "-L/home/your_name/anaconda3/envs/myenv/lib",
      "-lpython3.9",
      "-lglib-2.0",
      "-o",
      "${fileDirname}/${fileBasenameNoExtension}"
  ]
  

• 配置校验：如果修改后依然提示找不到某个头文件，直接把编译日志里-I后面的对应路径复制出来，在终端执行ls 路径/头文件名，确认文件真实存在，路径写错就调整到正确为止。

• 所有编译参数里的路径尽量写绝对路径，不要依赖shell的路径展开特性，避免VS Code执行任务时因为环境变量、展开逻辑差异导致路径失效。
• 不要尝试用通配符一次性添加所有子目录的头文件路径，用到哪个目录就明确写哪个目录的路径，递归通配对gcc的-I参数无效。
• 编译C程序引入第三方依赖时，除了添加头文件搜索路径，必须通过-L指定库文件搜索路径、-l指定要链接的库名，否则无法完成编译链接。

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