Mac版Qt Creator安装配置入门指南

最近好几个朋友问我，刚买了Mac想学Qt开发，结果卡在装环境这一步，折腾一下午都没跑起来。其实qt creator for Mac的安装没想象中那么玄乎，主要是网上教程太老，好多还停留在Qt5时代，照着做容易踩坑。我把自己在M1 Mac和Intel Mac上都实测过的流程整理出来，从下载到配置再到跑通第一个demo，跟着走基本不会翻车。

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

先搞清楚你要下哪个版本，别急着点下载

打开Qt官网，很多人第一眼就懵了，一堆版本号不知道选哪个。我的建议是，如果你是纯新手，直接选最新的LTS长期支持版，比如Qt 6.5或者6.8，稳定性和社区资料都跟得上。qt creator for Mac其实是集成在Qt Online Installer里的，不需要单独去找安装包。注意看页面上的macOS标签，现在官网会自动识别你的芯片类型，M系列和Intel的安装器是同一个，装的时候会自动适配。有个小坑提醒一下，下载之前得注册一个Qt账号，邮箱别乱填，后面登录要用。下载速度取决于网络，慢的话挂个代理会快很多。

安装过程看着步骤多，其实关键就那几处勾选

双击下载好的.dmg文件，会弹出一个安装向导。第一步让你登录Qt账号，登进去之后会问你是个人用户还是公司用户，个人学习选Personal就行，免费。接下来是选择安装路径，默认路径就行，没必要改。重点是组件选择页面，这里千万别全勾，不然硬盘直接爆炸。新手只需要勾选Qt版本下的macOS桌面套件，比如Qt 6.8.0下面的macOS那一项，再加上Qt Creator本身。Additional Libraries里面有个Qt Debug Information Files，建议勾上，调试的时候有用。其他什么Android、iOS、WebAssembly统统不勾，等你以后需要了再回来装。整个安装过程大概要十几分钟，取决于网速和硬盘速度，耐心等就行。

第一次打开Qt Creator，这几个设置先改掉

装完之后在启动台里找到Qt Creator，图标是一个白底绿色的锤子。第一次打开可能会提示你允许来自未知开发者的应用，去系统设置隐私与安全性里点仍然打开就行。进去之后界面是英文的，想换中文的话在Preferences里找Environment，Locale改成Chinese。不过我个人建议别改，英文界面用习惯了查资料更方便，很多报错信息也是英文的，直接搜更容易找到答案。接下来检查一下Kits，在Preferences的Kits页面里，应该能看到自动检测到的Desktop Qt套件，前面有个绿色对勾说明配置正常。如果显示感叹号，多半是Xcode Command Line Tools没装，打开终端输入xcode-select --install装一下就好。

跑通第一个项目，验证环境有没有问题

点File新建项目，选Application下的Qt Widgets Application，名字随便起个HelloMac。构建系统保持默认的qmake或者CMake都行，新手用qmake更简单。一路下一步到完成，然后点左下角的绿色三角形运行。如果弹出一个空白窗口，恭喜你，qt creator for Mac环境已经跑通了。要是报错说找不到编译器，回去检查Kits页面里的编译器路径是不是空的，手动指到/usr/bin/clang++就行。我第一次装的时候就是卡在这，后来发现是Xcode没装全，折腾了半小时。

几个新手常踩的坑，提前帮你避了

第一个坑是安装到一半卡住不动，多半是网络问题，关掉重来换个时间段再试。第二个坑是M系列芯片的Mac装完运行特别慢，检查一下是不是装了Rosetta版本的Qt，在Activity Monitor里看进程类型，如果是Intel说明装错了，重新下载arm64版本。第三个坑是Qt Creator里代码提示不工作，去Preferences的Text Editor里把ClangCodeModel打开。第四个坑是编译报错说SDK版本不对，在Projects的Build Environment里把QMAKE_MAC_SDK改成macosx就行。

日常使用的一些小建议

平时写代码的时候，Qt Creator的快捷键跟Xcode不太一样，Command+B是编译，Command+R是运行，Command+Shift+F是全局搜索。建议花十分钟把快捷键过一遍，效率能提升不少。另外qt creator for Mac的插件系统挺丰富的，但新手别急着装一堆插件，先把自带的用熟再说。如果遇到中文乱码，在文件编码设置里改成UTF-8就行。总的来说Mac上搞Qt开发体验还是不错的，环境搭好之后基本不用再折腾，安心写代码就完事了。