错误源于使用gcc而非g++编译c++文件，因gcc不搜索c++标准库路径；应改用g++命令、确认g++已安装（如sudo apt install g++），并检查头文件路径是否正确配置。
g++没装，却用gcc编译.cpp文件
这是最常见也最容易被忽略的起点。错误信息 fatal error: iostream: No such file or directory 往往不是库真丢了，而是你根本没调用C++编译器。
gcc是C编译器，它默认不搜索C++标准库路径；g++才是C++编译器，会自动链接libstdc++并包含标准头文件路径。
- 检查命令是否用了
gcc：比如gcc main.cpp -o main→ 改成g++ main.cpp -o main - 确认
g++已安装：g++ --version能输出版本号才算到位 - Ubuntu/Debian用户常漏装
g++包（只装了build-essential有时也不够）：sudo apt install g++
头文件路径未被编译器识别
即使g++存在，也可能因路径配置异常找不到iostream——尤其在自定义工具链、WSL子系统或Docker容器中。
运行g++ -v -E /dev/null（注意是小写-v加-E），看输出末尾的#include <...> search starts here:</...>部分，确认类似/usr/include/c++/11或/usr/include/c++/13的路径是否存在且可读。
- 若路径缺失或为空，说明g++安装不完整，重装
g++或对应libstdc++-dev包（如sudo apt install libstdc++-dev） - 若路径存在但版本号不对（比如显示
/usr/include/c++/9，而你系统实际是/usr/include/c++/13），可能是多版本共存导致选错，默认链接器没跟上 - 临时绕过：用
-I手动指定，例如g++ -I/usr/include/c++/13 main.cpp（不推荐长期使用）
文件扩展名或编译选项误导编译器
g++会根据文件后缀推断语言标准，但这个行为可被覆盖，且容易出错。
- 用
.c后缀写C++代码？g++会当C处理，跳过C++头文件搜索 → 改后缀为.cpp或.cc - 显式加
-x c++强制语言类型：g++ -x c++ main.c -o main -
-std=选项本身不解决“找不到头文件”，但它影响宏定义和特性启用；如果头文件找到了却报std::cout未声明，才需检查-std=c++11等是否启用
IDE或编辑器配置与命令行不一致
VS Code、CLion等工具常自带编译任务，但它们可能缓存旧配置、调用错误的工具链，或未继承shell环境变量。
- 在终端里能跑通
g++ main.cpp，但在VS Code里报iostream not found？大概率是C/C++插件的includePath没同步系统路径 - 检查VS Code的
c_cpp_properties.json，确认"includePath"包含类似/usr/include/c++/${version}的实际路径（可用find /usr/include -name iostream 2>/dev/null定位） - Clangd等LSP服务不会自动读取
g++ -v的路径，必须显式配"compileCommands"或"browse.path"
iostream本身坏了，而是你调用它的那个“上下文”——编译器、路径、后缀、配置——其中一环静默失效了。逐项验证比盲目加-I或改using namespace std更有效。
