VSCode中红色波浪线提示“cannot open source file”是C/C++插件未找到头文件路径所致，需正确配置compilerPath和includePath，并重置IntelliSense数据库。
红色波浪线提示 cannot open source file 不是编译失败，而是 VSCode 的 C/C++ 插件找不到头文件路径——它压根没在你写的 #include <iostream> 或 #include "my_header.h" 对应的目录里搜索过。
确认 compilerPath 是否真实可用
IntelliSense 会根据 compilerPath 自动推导系统标准库路径（比如 /usr/include/c++/11）。如果这个路径填错了，后续所有自动补全都失效。
- 先在终端运行
which g++，拿到真实路径（如/usr/bin/g++），别写g++这种裸名 - 打开命令面板（
Ctrl+Shift+P），执行C/C++: Edit Configurations (JSON)，检查compilerPath字段是否与之完全一致 - 交叉编译环境（如
arm-linux-gnueabihf-g++）必须填完整路径，并验证该工具链能输出头文件路径：arm-linux-gnueabihf-g++ -v -E -x c++ - < /dev/null - 如果
compilerPath指向一个权限不足、损坏或根本不存在的二进制，IntelliSense 就会静默放弃推导，只依赖你手动写的includePath
includePath 必须覆盖三类路径且格式正确
includePath 是 IntelliSense 唯一信任的“搜索地图”，它不读 Makefile、不继承 shell 环境变量、也不自动扫描子目录——每一条都得你亲手列清楚。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 项目本地头文件：用
"${workspaceFolder}/include/**"（末尾/**表示递归包含子目录；漏掉就找不到include/utils/log.h） - 系统标准路径：从
g++ -v -E -x c++ - < /dev/null输出中复制#include <> search starts here:下的所有行，每行转为一个字符串（例如"/usr/include/c++/11"、"/usr/include/x86_64-linux-gnu/c++/11"） - 第三方库路径：如
libpcl-dev安装后头文件在/usr/include/pcl-1.10，ROS 用户还需加/opt/ros/humble/include - 不要用通配符省略架构路径（如漏掉
x86_64-linux-gnu子目录），否则#include <thread>一定报红
改完配置后必须重置 IntelliSense 数据库
VSCode 不会自动重新索引。你看到的还是旧缓存，尤其之前配错过、或切换过 GCC 版本时，残留数据会导致“明明改对了却还报错”。
立即学习“C++免费学习笔记（深入）”；
- 按
Ctrl+Shift+P，输入并执行C/C++: Reset IntelliSense Database - 等右下角状态栏出现
IntelliSense is re-indexing…，直到变成Ready - 如果仍不生效，关闭所有文件夹，再用
File → Open Folder重新打开项目（避免残留旧工作区配置） - 别信“保存即生效”——不重置，等于没改
最容易被忽略的是：includePath 里漏掉架构特定路径（比如 /usr/include/x86_64-linux-gnu/c++/11），或者 compilerPath 指向了一个无法执行的链接或旧版本符号。这两处一错，整个 IntelliSense 的路径推导就崩了，再多的 ** 也救不回来。
