macos 的 gcc 命令默认指向 apple clang 而非 gnu gcc，因苹果自 xcode 4.2 起将其设为软链接；需先装 xcode command line tools（提供头文件与工具），再用 homebrew 安装 gcc-14 等真实版本，并显式调用以避免 abi 和标准库（libc++/libstdc++）混用导致的链接错误。

macOS 上的 gcc 命令默认不是 GNU GCC，而是 Apple Clang 的符号链接——你运行 gcc --version 看到 “Apple clang” 就说明还没装真正的 GNU GCC。

为什么 gcc 不是 GCC？

macOS 自带的 gcc、g++ 都只是指向 clang 和 clang++ 的软链接，这是苹果从 Xcode 4.2 开始就确立的设计。它不提供 GNU 工具链特有的行为（比如 -fopenmp 默认启用方式、某些 ABI 规则、libstdc++ 默认链接），也不支持部分 GCC 专属扩展。

• 验证方法：gcc --version 输出含 Apple clang；which gcc 返回 /usr/bin/gcc
• Clang 默认用 libc++，GNU GCC 默认用 libstdc++，混用会触发链接错误（如 undefined reference to '__cxa_throw'）
• 如果你需要 C++23 某些实验性特性、或与 Linux CI 环境保持 ABI 一致，才真正需要 GNU GCC

必须先装 Xcode Command Line Tools

这不是可选项——Homebrew 安装 GCC 时依赖它提供的系统头文件（/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include）和构建工具（make、ar、strip）。没它，GCC 编译会报 fatal error: 'stdio.h' file not found。

macOS Local Voice

利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。

下载

• 执行 xcode-select --install，点弹窗“安装”，等进度条结束
• 安装完立刻运行 sudo xcode-select --reset，避免旧路径残留（尤其换过 Xcode 版本后）
• 检查是否生效：xcode-select -p 应输出 /Library/Developer/CommandLineTools
• 别跳过这步直接 brew install gcc——90% 的头文件缺失错误都源于此

用 Homebrew 安装真正的 GCC（推荐）

Homebrew 是目前最稳定、更新及时的方式。它把 GCC 安装在独立路径（Apple Silicon 是 /opt/homebrew/bin/，Intel 是 /usr/local/bin/），不干扰系统，且自动处理 gmp、mpfr、libmpc 等依赖。

• 先装 Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 再装 GCC：brew install gcc（当前装的是 gcc-14，未来会是 gcc-15）
• 验证：gcc-14 --version 应显示 gcc (Homebrew GCC 14.x) 14.x.x
• 编译时必须用带版本号的命令：gcc-14 hello.c -o hello，g++-14 main.cpp -o main

要不要让 gcc 直接调用 GNU 版本？

可以，但需手动干预，且有风险：一旦后续升级 Homebrew GCC 或重装系统，软链接或别名可能失效，导致编译器行为突变（比如突然用回 Clang 却没察觉）。

• 安全做法：始终用 gcc-14 / g++-14 显式调用，避免歧义
• 若坚持改默认：echo 'alias gcc="gcc-14"' >> ~/.zshrc && source ~/.zshrc（注意 Shell 类型）
• 更激进的方案：sudo ln -sf $(which gcc-14) /usr/local/bin/gcc，但需确保 /usr/local/bin 在 $PATH 前置位置
• VS Code 的 c_cpp_properties.json 中填 "compilerPath": "/opt/homebrew/bin/gcc-14"，比改全局更稳妥

最容易被忽略的是：Clang 和 GCC 对同一段 C++ 代码可能给出不同警告、甚至不同编译结果；而 macOS 的 SDK 路径、sysroot 参数、标准库选择（-stdlib=libc++ vs -stdlib=libstdc++）这些细节，远比“装上就能用”复杂得多。