最近换了Mac之后一直想把Qt开发环境搭起来，之前Windows上那套东西搬过来发现完全不是一回事。网上搜了一圈教程要么太老要么缺步骤，干脆自己折腾完把过程记下来。这篇qt creator for Mac安装配置教程会从下载镜像开始，一直到建好项目跑起来，中间遇到的坑我都会标出来，你照着走基本不会卡住。
先去官网把该下的东西下齐
很多人第一步就搞错了，直接去搜qt creator for Mac下载，结果下回来一个光秃秃的IDE，打开发现没有编译器也没有Qt库，新建项目全是灰的。正确的做法是去Qt官网下那个在线安装器，文件名一般是qt-unified-macOS-x64-online.dmg这种。下之前你得先注册一个Qt账号，别嫌麻烦，后面安装的时候必须登录才能继续。
打开dmg之后把安装器拖进Applications，然后双击运行。这时候Mac可能会弹窗说“无法验证开发者”，别慌，去系统设置里隐私与安全性那边点仍要打开就行。登录账号之后会让你选安装目录，默认是~/Qt，建议别改，后面配置环境变量的时候省事。
组件选择这块别贪多
到了选组件的界面，左边一堆版本号容易看花眼。我的建议是选最新的LTS版本，比如6.5或者6.8，别追太新的。然后重点来了，展开Qt下面的子项，把macOS那个勾上，这是给Mac原生编译用的。如果你还要做iOS开发就顺手把iOS也勾了，不需要就别选，省好几个G空间。
再往下翻找到Developer and Designer Tools，这里面的Qt Creator是默认勾上的，不用动。但你要确认一下CMake和Ninja有没有被选上，现在新版本Qt默认用CMake构建，没这俩后面编译会报错。全部选好之后点下一步，等它下载安装就行，整个过程看网速，慢的话半小时也正常。
装完先别急着打开项目
安装完成之后你会在启动台看到Qt Creator的图标，但先别急着点。打开终端输一下qmake --version看看能不能找到命令，如果提示command not found，说明环境变量没配。Mac现在默认用zsh，你得编辑~/.zshrc文件，加一行export PATH="$HOME/Qt/6.5.0/macos/bin:$PATH"，具体版本号看你装的是哪个。保存之后执行source ~/.zshrc让它生效。
这一步很多qt creator for Mac教程都跳过了，导致后面编译的时候找不到qmake。我当初就是卡在这里，明明Qt Creator里能识别到套件，但终端里就是不行，折腾了快一个小时才发现是环境变量的事。
配置编译套件其实没那么玄乎
打开Qt Creator之后去偏好设置里面找Kits这一项。正常情况下它会自动检测到你装好的Qt版本和编译器，你只需要确认一下Desktop那个套件前面有没有黄色感叹号。如果有，点进去看看是哪个环节缺了，一般是编译器路径没填对。Mac上用的是Clang，路径通常在/usr/bin/clang++，Qt Creator一般能自动找到。
还有一个容易忽略的点，就是Xcode的命令行工具。如果你没装过，去终端执行xcode-select --install，弹窗点安装等它下完。没这个东西Clang编译器用不了，套件配置那一步会一直报错。装完之后重启一下Qt Creator，套件应该就变绿了。
跑个Hello World验证一下
新建项目选Qt Widgets Application，名字随便起，路径别带中文。构建系统选CMake，基类选QWidget就行。一路下一步之后点左下角那个绿色的三角按钮，等几秒钟应该会弹出一个空白窗口。看到窗口那一刻说明你的qt creator for Mac环境算是彻底配好了。
如果编译报错说找不到头文件，大概率是套件没选对，回去检查一下Kits里面是不是选了Desktop。要是报链接错误，看看是不是Xcode命令行工具没装好。还有一种情况是Mac系统权限问题，去设置里给Qt Creator完全磁盘访问权限，虽然不一定需要但加上省心。
几个过来人的小提醒
Mac上装Qt其实比Windows省事，没那么多注册表之类的破事，但坑主要集中在环境变量和Xcode工具链上。另外如果你用的是M系列芯片的Mac，注意下载的时候选arm64版本的安装器，虽然x64的也能跑但性能差一截。还有Qt Creator的版本别跟Qt库版本差太远，不然调试器可能连不上。
最后说一句，配置环境这种事第一次弄肯定要花点时间，但弄好之后就是一劳永逸。实在卡住了就去Qt官方论坛搜一下报错信息，大部分问题都有人遇到过。希望这篇qt creator for Mac教程能帮你少走点弯路，顺利把开发环境跑起来。
喜欢 
高兴
鬼脸
呵呵
无聊
伤心
