macOS下g++正常但g++-14编译报错问题求助

问题根源 #

出现__API_AVAILABLE0参数不匹配、__API_UNAVAILABLE3未定义这类错误，是因为macOS系统SDK头文件（比如<Availability.h>）里的可用性宏，和GCC 14的预处理逻辑不兼容。当代码包含<iostream>时，会间接引入这些系统宏，而GCC对宏的解析方式和Apple Clang不一致，从而触发报错。

可行解决方案 #

1. 编译时添加兼容参数 #

编译命令里加上两个关键参数，强制GCC适配Apple的宏定义规则：

g++-14 -std=c++20 -fmacro-backtrace-limit=0 -D__ASSERT_MACROS_DEFINE_VERSIONS_WITHOUT_UNDERSCORES=0 your_code.cpp -o your_program

-std=c++20可以换成你需要的更高版本（比如c++23）。

2. 重新安装并确认GCC环境 #

先确保Homebrew的GCC安装完整，运行：

brew reinstall gcc

然后检查调用的是不是Homebrew版本的g++-14，执行which g++-14，输出应该是/usr/local/bin/g++-14（Intel Mac）或/opt/homebrew/bin/g++-14（Apple Silicon），如果不是，需要调整环境变量优先指向Homebrew的bin目录。

3. 指定GCC自带标准库（可选） #

如果代码不需要macOS特定API，可以强制使用GCC自己的标准库，绕过系统SDK的头文件冲突：

# 先获取GCC的标准库路径
g++-14 -print-search-dirs | grep install
# 把下面的路径替换成上面输出的实际路径
g++-14 -std=c++20 -nostdinc++ -I/opt/homebrew/Cellar/gcc/14.1.0/lib/gcc/current/include/c++ -I/opt/homebrew/Cellar/gcc/14.1.0/lib/gcc/current/include/c++/aarch64-apple-darwin23 your_code.cpp -o your_program

4. 降级到GCC 13（临时方案） #

如果上面的方法都无效，GCC 13对macOS SDK的兼容性更稳定，可以降级安装：

brew install gcc@13
g++-13 -std=c++20 your_code.cpp -o your_program

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