Qt Creator Mac安装配置入门指南

最近不少朋友问我，Mac 上到底怎么装 Qt Creator 才不折腾。说实话我第一次装的时候也绕了点弯路，下载页面一堆版本看花眼，装完还发现套件没配好，编译按钮是灰的。所以这篇就把 qt creator for Mac 从下载、安装到配置、跑通第一个程序的完整过程捋一遍，尽量说人话，你照着做基本能一次过。不管你是刚学 C++ 的学生，还是想在新 Mac 上搭个开发环境的老手，这篇都能用得上。

应用名称：qt creator for Macv20.0.1官方版 下载地址：https://m.fxxz.com/f/777372

先去官网下对版本，别乱点

打开浏览器搜 qt creator for Mac，认准 Qt 官网的下载页。这里有个小坑：页面会引导你下在线安装器，文件不大，但装的时候要登录 Qt 账号，没账号现场注册一个就行，免费的。选版本的时候别追最新，选 LTS 长期支持版更稳，比如 Qt 6 的 LTS 分支，社区资料多，出问题好搜。另外注意看芯片类型，M 系列和 Intel 的包不一样，下错了装完跑不起来。我头一回就下成 Intel 版，在 M2 上折腾半天，卸了重装才反应过来。

拖拽安装，几步就完事

下载完是个 dmg 镜像，双击打开，把 Qt Creator 图标拖进 Applications 文件夹，这就装好了。第一次打开会提示“来自互联网的 App”，点打开就行。接着在线安装器会问你要装哪些组件，新手建议至少勾上 macOS 桌面开发那一套，包括编译器和 Qt 库，别嫌大，后面省事。装的过程中要等一会儿，网速慢的话泡杯茶。装完启动，界面是英文的，别慌，下一步教你怎么调。

配置编译套件，这步最关键

很多人卡在这：装完了新建项目，编译按钮是灰的。原因就是 qt creator for Mac 的套件（Kit）没配好。进偏好设置里的 Kits 选项，看看编译器有没有自动识别到 Clang，Qt 版本有没有关联上。正常情况下装完会自动配好一个桌面套件，如果显示叹号，手动选一下编译器路径和 Qt 版本就行。我建议顺手把构建目录设成项目外的一个固定文件夹，不然项目多了找编译产物很烦。配好之后回到项目页，套件下拉框选上，按钮就亮了。

调成中文界面，看着顺眼

英文界面用着也行，但新手容易懵。想换中文的话，在偏好设置里找环境->界面语言，选简体中文，重启生效。不过要提醒一句，部分版本的翻译不全，个别菜单还是英文，属于正常现象，不影响使用。另外字体大小也可以调，Mac 高分屏下默认字有点小，调到 13 到 14 号看着舒服。这些小设置花不了几分钟，但每天写代码心情会好很多。

跑通第一个程序，验证环境

环境配好就来点实际的。新建项目选 Qt Widgets Application，一路下一步，构建系统用 qmake 或 CMake 都行，新手先用 qmake 简单。生成后直接点左下角的绿色三角运行，第一次编译会慢一点，等它跑完弹出一个空白窗口，恭喜你，qt creator for Mac 算是彻底跑通了。要是报错，八成还是套件没选对，回去检查一下。我建议再手动改改窗口标题，重新编译一次，确认改动生效，这样心里有底。

几个新手常踩的坑

最后说几个实测遇到的问题。一是命令行工具没装，编译时报 xcrun 错误，终端跑一句 xcode-select --install 就好。二是路径里有中文或空格，偶尔导致构建失败，项目尽量放英文目录。三是升级系统后套件失效，重新进偏好设置点一下自动检测基本能恢复。四是别同时开多个版本的 Qt Creator，容易串环境。这些都是我或者身边朋友真实踩过的，记下来能省不少时间。

总的来说，qt creator for Mac 的安装配置并不复杂，关键就是下对包、配好套件、跑通第一个程序。按上面步骤走一遍，半小时内基本能搞定。后面就是慢慢熟悉快捷键和调试功能了，环境这关过了，剩下都是顺手的事。