Homebrew安装Qt最省事，能自动匹配Qt框架、编译器与环境变量；需先运行xcode-select --install安装命令行工具，再brew install qt（含qmake等），最后brew install qt-creator复用已装Qt。
直接用 Homebrew 安装最省事，能自动处理 Qt 框架、编译器、环境变量三者的匹配问题。手动下载官网安装包容易卡在登录环节，或装完发现 qmake 找不到、Kit 配置失败——这些都不是配置问题，而是版本链断裂导致的。
为什么 xcode-select --install 必须先跑一遍
Qt Creator 在 macOS 上构建项目时，底层调用的是 clang 和 libtool 等命令行工具，不是图形界面的 Xcode.app。即使你没装 Xcode，也必须装它的命令行工具：
- 运行
xcode-select --install后弹窗点“安装”，等约 1GB 下载完成 - 验证：终端执行
clang --version，有输出即成功 - 如果提示“already installed”但
qmake仍报错，可能是路径未关联，补一句sudo xcode-select --reset - 不装这个，后续所有 Qt 构建都会卡在
Project ERROR: Xcode not set up properly
brew install qt 装的是什么，和 Qt Creator 什么关系
Homebrew 的 qt 公式（formula）默认只装 Qt 框架本身（含 qmake、uic、moc 等工具），不包含 IDE。但它是 Qt Creator 正常工作的基础：
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
- 执行
brew install qt后，Qt 被装到/opt/homebrew/opt/qt（M1/M2）或/usr/local/opt/qt（Intel） - 这个路径下有完整的
bin/、lib/、plugins/，Qt Creator 启动后会自动扫描该位置识别 Qt 版本 - 如果你后续要装 Qt Creator，
brew install qt-creator会自动依赖并复用已装的qt，不会重复下载 - 别用
brew install qt@5这类旧版公式——它不带qmake的符号链接，Qt Creator 找不到有效 Qt 版本
Qt Creator 安装后 Kit 配置失败的三个常见原因
打开 Qt Creator → Preferences → Kits → Compilers / Qt Versions / Kits，常见断点不在“怎么配”，而在底层路径没暴露出来：
-
Compilers列表为空？检查是否运行过xcode-select --install；再确认clang++ --version能执行 -
Qt Versions扫不到？手动添加路径：/opt/homebrew/opt/qt/bin/qmake（M1/M2）或/usr/local/opt/qt/bin/qmake（Intel） -
Kits显示 “No valid kits found”？确保同一行里 Compiler 和 Qt Version 都选中了，且 Architecture 是x86_64或arm64（与你的芯片一致） - 如果装了多个 Qt（比如官网版 + brew 版），Qt Creator 可能混用路径，建议卸载官网版，只留 brew 管理的一套
真正麻烦的不是安装动作本身，而是 Qt Creator 启动时自动探测机制对 PATH 和磁盘权限的隐式依赖——它不会告诉你缺了哪个 dylib，只会安静地显示灰色 Kit。所以装完 brew 版 Qt 后，务必关掉 Qt Creator 再重开一次，让它重新扫描。
