M1芯片MacBook Air编译引入Boost的C++程序提示头文件未找到

编译命令存在3处参数错误，直接导致头文件搜索失败：

1. 指定头文件搜索路径需要使用大写的-I（include首字母）参数，你写的小写-l是声明链接库的参数，编译器完全不会把后面跟的路径当头文件搜索目录处理。
2. -l参数和要链接的库名之间不能加空格，你写的-l boost_thread-mt写法会导致参数识别异常。
3. 没有指定库文件搜索路径，M1芯片Mac上Homebrew的库存放路径为/opt/homebrew/lib，就算解决头文件问题，后续也会报找不到链接库的错误。

额外说明：M1 Mac默认终端输入gcc/g++调用的是Xcode内置的clang编译器，不是GNU GCC，这个不影响Boost程序正常编译，如果有特殊需求必须用GNU GCC，需要先执行brew install gcc，调用时带版本号（比如g++-14），直接敲g++还是会调用系统内置clang。

• 先验证Boost安装完整性，执行以下命令，能正常返回文件路径就说明文件没有损坏：

ls /opt/homebrew/include/boost/thread.hpp

• 使用修正后的编译命令构建程序：

g++ mythread.cpp -o mythread -I/opt/homebrew/include -L/opt/homebrew/lib -lboost_thread-mt

参数对应作用：

• -I/opt/homebrew/include：添加Homebrew头文件搜索目录
• -L/opt/homebrew/lib：添加Homebrew库文件搜索目录
• -lboost_thread-mt：链接Boost多线程动态库
• 如果后续编译其他Homebrew安装的依赖不想每次手动写路径，可以把路径加到全局编译环境变量，执行以下命令写入zsh配置（M1 Mac默认shell为zsh），重启终端后自动生效：

echo 'export CPPFLAGS="-I/opt/homebrew/include"' >> ~/.zshrc
echo 'export LDFLAGS="-L/opt/homebrew/lib"' >> ~/.zshrc
source ~/.zshrc

内容的提问来源于stack exchange，提问作者Jane Liu