You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Mac下Homebrew安装Qt运行异常,改用Qt@5尝试解决

解决Mac上Homebrew安装Qt后Qt Creator编译报错及qmake识别问题

我最近刚踩过这个一模一样的坑!用Homebrew装brew install qt和brew install qt-creator的时候全程没报错,结果启动Qt Creator不仅得手动选qmake,编译项目还直接弹出:-1: error: failed to parse default search paths from compiler output,折腾半天加环境变量也没用,最后换了个安装方式终于搞定了,步骤给你列出来:

解决步骤

1. 卸载原有Qt版本

先把之前装的标准Qt包彻底删掉:

brew remove qt
# 可选,清理残留文件
brew cleanup

2. 安装指定版本的Qt@5

Homebrew默认的qt包现在是Qt6,兼容性反而不如Qt@5稳定,我们换装Qt@5:

brew install qt@5

安装完成后,必须手动链接Qt@5的路径(Homebrew默认不会自动链接旧版本的公式):

brew link qt@5 --force

3. 配置Qt Creator识别Qt@5

启动Qt Creator后,按以下步骤配置:

  • 打开顶部菜单栏的「Qt Creator」→「Preferences」(如果是Windows风格的菜单就是「Edit」→「Settings」)
  • 切换到「Kits」选项卡,再点「Qt Versions」子标签
  • 点击右下角的「Add」按钮,找到Qt@5的qmake路径:
    • Intel芯片Mac:/usr/local/opt/qt@5/bin/qmake
    • M1/M2系列芯片Mac:/opt/homebrew/opt/qt@5/bin/qmake
  • 回到「Kits」主标签,找到你常用的编译套件(比如Desktop Qt 5.x.x clang 64bit),确保它关联的Qt版本是刚才添加的Qt@5
  • 点击「Apply」保存配置

4. 验证修复效果

新建一个简单的Qt Widgets项目,点击编译运行,应该不会再出现那个编译路径解析错误了。

为什么这个方法管用?

主要原因是Homebrew对Qt6的默认路径配置和Qt Creator的自动检测逻辑有冲突,导致Qt Creator没法正确识别编译器的搜索路径。而Qt@5作为长期支持版本,Homebrew对它的路径管理更成熟,手动链接后系统和Qt Creator都能精准找到完整的工具链,自然就解决了编译报错和qmake识别的问题。

内容的提问来源于stack exchange,提问作者Josh

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.19 08:02:48