VSCode“找不到头文件”是IntelliSense路径配置问题，非编译错误；应通过C/C++: Edit Configurations (UI)自动生成c_cpp_properties.json，检查includePath是否含正确绝对路径、系统头路径及workspaceFolder变量，确保compilerPath匹配实际编译器，并重启IntelliSense引擎。
VSCode报“找不到头文件”不是编译失败，而是IntelliSense没拿到正确的头文件路径——includePath配错、没配、或被其他配置覆盖了，代码照样能编译通过，但跳转、补全、红波浪线全崩。
怎么快速生成并检查c_cpp_properties.json
别手动建文件，容易格式出错。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 C/C++: Edit Configurations (UI)，回车。VSCode会自动在 .vscode/ 下生成标准 JSON，并打开图形界面。
- 如果没反应，先确认已安装官方
C/C++扩展（ID：ms-vscode.cpptools） - 生成后立刻检查
.vscode/c_cpp_properties.json是否存在且非空；空文件或只有{}说明生成失败 - 右下角状态栏点
C/C++，确认当前激活的是你刚配的 configuration（比如Win32或Linux），不是Default
includePath里该填什么、不该填什么
它是一个路径数组，每项必须是完整绝对路径或带 ${workspaceFolder} 的合法变量表达式。IntelliSense 不支持 glob 通配符（如 /usr/include/**），但支持 ** 表示递归子目录（仅用于末尾）。
- 系统标准库路径必须显式加上：
/usr/include/c++/11（Ubuntu）、/opt/homebrew/opt/llvm/include/c++/v1（macOS M1 + Homebrew LLVM）、C:/Program Files/mingw64/x86_64-w64-mingw32/include/c++（MinGW） - 项目内头文件用
"${workspaceFolder}/include"或"${workspaceFolder}/src/include"，别漏掉${workspaceFolder}前缀 - 第三方库路径要指向
包含头文件的父目录：OpenCV 要加/usr/include/opencv4（不是/usr/include/opencv4/opencv2），GLFW 要加含GLFW/glfw3.h的那个include目录 - 删掉所有带
*的路径（如/usr/include/c++/*），VS Code 不识别；也别写./include，相对路径无效
为什么改了includePath还是不生效
最常见原因是 compilerPath 没配对，或 configurationProvider 接管了配置。
-
compilerPath必须设为真实使用的编译器绝对路径，比如/usr/bin/clang++或C:/msys64/mingw64/bin/g++.exe；只写g++会导致 IntelliSense fallback 到错误的系统头推导逻辑 - 如果你装了
CMake Tools插件且项目有CMakeLists.txt，c_cpp_properties.json里的includePath默认被忽略——删掉或注释掉"configurationProvider": "ms-vscode.cmake-tools"字段，或干脆把整个字段设为null - 改完保存后，必须执行
Ctrl+Shift+P → C/C++: Restart IntelliSense Engine，或关闭再重开窗口；缓存不刷新，改等于白改 - 路径含中文或空格？Windows 下务必用双引号包裹整个路径字符串，JSON 解析器会直接报错
第三方库头文件仍标红？先定位真实路径
别猜、别抄网上的路径。用命令查真实安装位置：
- Linux/macOS：
pkg-config --cflags opencv4（输出类似-I/usr/include/opencv4），或find /usr -name "opencv2" 2>/dev/null | head -n1 | xargs dirname - macOS Homebrew：
brew --prefix opencv，然后拼成$(brew --prefix opencv)/include/opencv4 - vcpkg 用户：
vcpkg list | grep opencv，路径通常是vcpkg/installed/x64-linux/include（注意是include目录本身，不是vcpkg/installed/x64-linux） - Windows MSVC + vcpkg：路径形如
C:/vcpkg/installed/x64-windows/include，别漏掉x64-windows子目录
复杂点在于：路径必须展开成绝对路径，%OPENCV_DIR% 或 $HOME 这类环境变量在 JSON 里完全不解析；同时，多个第三方库路径之间没有依赖顺序，但同名头文件会被前面的路径优先匹配——把项目专用路径放前面，系统路径放后面。
