intellisense 失效主因是配置作用域不匹配或路径未生效：需确保 c_cpp_properties.json 中 configuration 名与状态栏一致、使用绝对路径或合法变量、compilerpath 与 intellisensemode 匹配，并手动重选配置触发加载。
这不是编译失败，是 IntelliSense 没拿到正确路径——代码能编译通过，但跳转、补全、红波浪线全失效。
为什么改了 includePath 还是报“找不到头文件”
最常见原因不是路径写错了，而是配置没对上作用域：
- 右下角状态栏显示的 configuration 名（比如
linux）和c_cpp_properties.json里当前激活的configurations[0].name不一致（大小写敏感） -
.vscode/c_cpp_properties.json不在你用 VSCode “Open Folder” 打开的那个根目录下，而在子文件夹里 -
compilerPath指向/usr/bin/gcc，但实际构建用的是aarch64-linux-gnu-gcc，IntelliSense 就不会自动推导那套系统头路径 - 用了
configurationProvider（比如 CMake Tools），它会接管includePath，手动配的被忽略
c_cpp_properties.json 里 includePath 怎么填才有效
必须是绝对路径或合法变量表达式，IntelliSense 不认相对路径、不支持通配符 *：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 项目内头文件：用
"${workspaceFolder}/include"或"${workspaceFolder}/src/include"，别漏${workspaceFolder} - 系统标准库：显式加完整路径，例如 Ubuntu 上要加
/usr/include/c++/11，macOS M1 + Homebrew LLVM 要加/opt/homebrew/opt/llvm/include/c++/v1 - 第三方库（如 OpenCV）：路径必须指向包含
opencv2/的父目录，即/usr/include/opencv4，不是/usr/include/opencv4/opencv2 - 删掉所有带
*的条目（如/usr/include/c++/*），VS Code 解析不了；也别写./include，它无效
Clang 用户特别注意：intelliSenseMode 和 compilerPath 必须匹配
VSCode 默认用 MSVC 引擎，Clang 项目会挂掉：
-
compilerPath设为/usr/bin/clang或/opt/homebrew/opt/llvm/bin/clang -
intelliSenseMode必须设成clang-x64（Linux/macOS）或clang-arm64（M1/M2），不能留默认的msvc-x64 - 如果用了 Clang+LLVM 工具链，
includePath里还得加上/opt/homebrew/opt/llvm/lib/clang/*/include（macOS）或/usr/lib/clang/*/include（Ubuntu）
编译能过但 IntelliSense 报错？检查 tasks.json 和 c_cpp_properties.json 是否脱节
两者路径不一致，就会出现“编辑器不认识，但编译器认识”的割裂：
-
c_cpp_properties.json里的includePath只管编辑器感知，不管编译；真正编译靠tasks.json里的-I参数 - 比如你在
tasks.json里写了"-I", "/path/to/mylib"，那c_cpp_properties.json里也得有对应路径，否则跳转失效 - 避免在
c_cpp_properties.json里重复加系统路径（如/usr/include），让 IntelliSense 从compilerPath自动推导更可靠
最容易被忽略的是：改完 c_cpp_properties.json 后，右下角点 C/C++ 状态栏，手动选一次刚配的 configuration——IntelliSense 不会自动 reload，得你点一下才生效。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
