gcc安装后找不到头文件主因是开发依赖未装全或路径未配置：ubuntu需libc6-dev或build-essential，centos需glibc-devel；第三方库缺-dev包；vscode需正确配置includepath并重启intellisense。
GCC安装后找不到头文件，基本不是GCC装错了，而是开发依赖没装全，或者路径没告诉编译器。
系统级头文件（如）都找不到
这是最基础的信号：你只装了gcc二进制，但没装配套的C标准库头文件和运行时支持。Ubuntu/Debian上常见于只执行sudo apt install gcc；CentOS/RHEL上常见于只装gcc包而没装glibc-devel或libgcc。
- Ubuntu/Debian：必须补装
libc6-dev（提供stdio.h、sys/cdefs.h等），推荐直接装build-essential（含gcc、g++、libc6-dev、make等） - CentOS/RHEL：装
glibc-devel（核心C头文件）和gcc-c++（如果用C++）；若用yum，运行sudo yum groupinstall "Development Tools"更省事 - 验证是否生效：运行
gcc -v -E -x c /dev/null 2>&1 | grep "search starts here"，看输出里是否有/usr/include或类似路径；再试find /usr/include -name stdio.h 2>/dev/null确认文件存在
第三方库头文件（如）报错
这类错误说明库本身已安装，但头文件不在GCC默认搜索路径里。典型场景是装了libssl1.1但没装libssl-dev（Debian系）或openssl-devel（RHEL系）。
- 先确认开发包是否安装：
dpkg -l | grep ssl-dev（Ubuntu）或rpm -qa | grep openssl-devel（CentOS） - 查头文件实际位置：
find /usr -name "ssl.h" 2>/dev/null，常见路径是/usr/include/openssl/ssl.h，但如果输出是/usr/include/x86_64-linux-gnu/openssl/ssl.h，说明头文件被架构子目录隔离了 - 临时编译加
-I：比如gcc -I/usr/include/x86_64-linux-gnu main.c；长期项目建议用pkg-config --cflags openssl自动获取正确路径
VSCode里红波浪线但命令行能编译通过
这是IntelliSense路径配置问题，和GCC本身无关。编辑器没读到你命令行里用的-I参数，也没继承系统头路径。
- 别手写
c_cpp_properties.json——按Ctrl+Shift+P→ 输入C/C++: Edit Configurations (UI)生成配置 -
includePath里必须填绝对路径，例如/usr/include、/usr/include/x86_64-linux-gnu，不能写./include或/usr/include/**（**只支持末尾递归） -
compilerPath务必填真实路径，如/usr/bin/gcc，而不是gcc——否则IntelliSense会推错系统头路径 - 如果用了CMake Tools插件，
c_cpp_properties.json里的includePath会被忽略，删掉或注释掉"configurationProvider": "ms-vscode.cmake-tools"这一行
CMake项目里include_directories()不生效
这个指令作用域是“后续定义的目标”，写在add_executable()之后就完全无效。而且它还是全局污染型写法，容易引发隐式依赖。
- 顺序必须是：先
include_directories(${CMAKE_SOURCE_DIR}/include)，再add_executable(...) - 更推荐改用
target_include_directories(my_target PRIVATE ${CMAKE_SOURCE_DIR}/include)，语义清晰、作用范围明确、且支持PRIVATE/PUBLIC/INTERFACE控制传播 - 如果用了
find_package(OpenCV)却找不到头文件，先运行dpkg-query -L libopencv-dev | grep include（Ubuntu）确认真实路径，再在CMakeLists.txt开头加set(CMAKE_PREFIX_PATH "/usr/include/opencv4" ${CMAKE_PREFIX_PATH})
最容易被忽略的是：头文件路径和库路径是两回事，-I管编译，-L和-l管链接；CPATH环境变量只影响#include <...></...>，不影响#include "..."；而VSCode的IntelliSense配置哪怕全对，也得手动重启引擎（C/C++: Restart IntelliSense）才生效。
