macOS下g++编译C++提示'Item.h'文件找不到如何解决

报错由两个常见的分离编译操作错误导致：

1. 你当前执行的编译命令仅将main.cpp作为编译输入，既没有告知g++头文件Item.h的搜索位置，也没有将Item类的实现源码（对应.cpp文件）加入编译链接流程。
2. 使用#include "Item.h"写法引用头文件时，g++默认仅在执行编译命令时的终端当前工作目录下搜索目标头文件，若Item.h不在该目录下，就会直接抛出'Item.h' file not found的致命错误。

• 先整理项目文件结构，入门阶段建议把所有相关源码、头文件放在同一项目根目录下，不要嵌套多层目录避免路径配置错误，标准结构参考：

your_project/
├── main.cpp   // 主程序文件
├── Item.h     // Item类声明头文件
└── Item.cpp   // Item类的具体实现代码

• 执行编译前先确认终端工作路径，通过cd命令切换到上述项目的根目录，再执行后续编译操作。
• 如果你的Item.h存放在项目的子目录下（比如专门建了include文件夹存放头文件），编译时需要通过-I参数显式指定头文件搜索路径，例如头文件存放在./include目录，就追加参数-I./include。
• 编译时必须把所有参与构建的.cpp实现文件都写入命令，正确的编译命令参考：

# 所有源文件、头文件都在项目根目录的情况
g++ main.cpp Item.cpp -std=c++11 -o my_program

如果头文件存放在独立的include目录，命令写法如下：

g++ main.cpp Item.cpp -std=c++11 -I./include -o my_program

编译无报错后，当前目录会生成名为my_program的可执行文件，执行./my_program即可运行程序。

补充说明：macOS下通过Xcode命令行工具默认安装的g实际是clang的软链接，上述编译参数完全兼容，无需额外调整。如果是通过Homebrew安装的原版GCC，命令逻辑完全一致，仅需将g++替换为对应版本的命令（例如g-14）即可。

内容的提问来源于stack exchange，提问作者Robert Zak