Windows环境下如何为GCC添加默认头文件包含路径
Windows下GCC添加默认头文件搜索路径操作指引
(适配入门开发用户搭配json-c库开发的场景)
前置验证
在修改全局默认配置前,建议先用单次编译的方式验证头文件路径是否正确,避免配置修改后排查问题麻烦:
- 找到本地json-c库的头文件存放绝对路径,比如解压后存放在
D:\dev\json-c\include目录下 - 编译测试代码时手动追加头文件路径参数,执行命令:
gcc demo.c -o demo.exe -I D:/dev/json-c/include -L D:/dev/json-c/lib -ljson-c - 如果这条命令能正常编译通过,说明填写的头文件路径有效,再进行后续全局默认配置操作
两种永久添加默认搜索路径的方案
方案1:修改GCC内置specs配置(稳定无环境变量依赖)
这是Windows下MinGW/MinGW-w64版本GCC的常用配置方式,不会受系统环境变量变动影响:
- 找到当前使用的GCC安装根目录(可在cmd里执行
gcc -v,输出里的configured with字段会标注安装路径),进入目录下的lib\gcc\<架构标识>\<GCC版本号>子文件夹,比如常见路径为C:\MinGW64\lib\gcc\x86_64-w64-mingw32\13.2.0 - 在该文件夹下打开命令提示符,执行命令生成可编辑的specs配置文件:
gcc -dumpspecs > specs - 用记事本打开新生成的
specs文件,搜索定位到*cpp:开头的配置行,在该行内容的末尾追加需要设置为默认搜索的头文件路径,格式为-isystem 你的头文件绝对路径(路径里的Windows反斜杠替换为正斜杠,避免转义错误),比如要添加json-c的路径就追加-isystem D:/dev/json-c/include - 保存修改后的specs文件,后续使用该版本GCC编译代码时,会自动把配置的路径加入默认头文件搜索列表,不需要每次编译手动写
-I参数
方案2:配置C语言头文件环境变量(操作简单)
如果不想修改GCC内部文件,可以通过系统环境变量实现全局默认搜索:
- 打开Windows系统的环境变量配置面板(此电脑右键→属性→高级系统设置→环境变量)
- 在用户变量或系统变量中新建变量,变量名固定为
C_INCLUDE_PATH - 变量值填写要添加的所有头文件绝对路径,多个路径之间用分号分隔,比如
D:/dev/json-c/include;D:/dev/other_dep/include - 保存配置后,重启所有已经打开的命令行窗口、代码编辑器,让环境变量生效即可
入门用户注意事项
- 配置完成后可以直接编译带
#include <json-c/json.h>的测试代码,编译时不手动追加-I参数,如果没有报“找不到头文件”的错误,就说明配置生效 - 不要把范围过大的目录(比如整个C盘根目录)加入头文件搜索路径,会大幅降低编译速度,还可能出现不同库的同名头文件冲突问题
- 如果电脑里安装了多个版本的GCC,配置前要确认当前默认调用的GCC路径,避免修改了不常用版本的配置,导致实际编译时不生效
内容的提问来源于stack exchange,提问作者Jostimian
相关产品推荐
相关产品推荐

