Ubuntu下VSCode中C/C++ includePath配置报错求解决方案

云上老周

2026-7-6

解决Ubuntu下VSCode C/C++ includePath报错问题

问题原因

你的c_cpp_properties.json中includePath为空数组，VSCode的IntelliSense无法定位标准库和项目头文件路径，因此触发报错。

解决步骤

1. 自动生成正确的includePath

VSCode的C/C++插件支持自动检测配置：

打开报错对应的C/C++文件（如g.c）
按下Ctrl+Shift+P打开命令面板
输入并选择C/C++: Edit Configurations (UI)
插件会自动检测GCC的标准库路径，自动填充Include Path字段
保存配置，插件将同步更新c_cpp_properties.json

2. 手动配置includePath（自动检测失效时）

先通过命令获取GCC的标准头文件路径：

gcc -v -E -x c -

执行后找到#include <...> search starts here:下方的所有路径，例如：

/usr/lib/gcc/x86_64-linux-gnu/11/include
/usr/local/include
/usr/include/x86_64-linux-gnu
/usr/include

将这些路径添加到includePath，同时加入项目根目录路径（方便引用本地头文件），修改后的配置示例：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                "/usr/lib/gcc/x86_64-linux-gnu/11/include",
                "/usr/local/include",
                "/usr/include/x86_64-linux-gnu",
                "/usr/include"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/gcc",
            "cStandard": "c17",
            "cppStandard": "c++98",
            "intelliSenseMode": "linux-gcc-x64"
        }
    ],
    "version": 4
}

注：${workspaceFolder}/**会递归包含项目根目录下所有子目录，适配本地头文件引用场景。