macOS安装Qt5.12.0后zsh终端提示qmake命令不存在如何解决

macOS Catalina 10.15.6 系统上已成功安装 Qt 5.12.0，Qt Creator 可正常启动，但 zsh 终端中执行所有 qmake 相关命令均提示命令不存在，已执行的排查命令及返回结果如下：

➜  ~ which qmake
qmake not found
➜  ~ qmake -qt=qt5
zsh: command not found: qmake
➜  ~ QT_SELECT=qt5 qmake
zsh: command not found: qmake
➜  ~ export QT_SELECT=qt5
➜  ~ which qmake
qmake not found
➜  ~ which qmake-qt5
qmake-qt5 not found

Qt 官方独立安装包默认不会自动把 qmake 等命令行工具的路径加入系统 PATH 环境变量。之前尝试的QT_SELECT相关配置是 Debian/Ubuntu 系 Linux 发行版中qtchooser工具的配套用法，macOS 下通过官方安装包装的 Qt 没有自带这个组件，所以这类操作完全起不到作用。

• 先确认本机 qmake 的实际存放路径
  Qt 5.12.0 默认安装路径下的 qmake 位置为/Users/你的系统用户名/Qt5.12.0/5.12.0/clang_64/bin/qmake，如果安装时改过路径，直接打开 Qt Creator，在「偏好设置-Kits-Qt版本」页面就能看到对应 qmake 的完整绝对路径，不用手动翻文件夹找。

• 将 qmake 所在的 bin 目录永久加入 zsh 环境变量
  终端执行命令编辑 zsh 配置文件：

  nano ~/.zshrc
  

  在文件最末尾追加一行配置，注意把路径替换成你自己机器上的实际 bin 目录路径：

  export PATH="/替换成你自己的qmake所在bin目录的完整路径:$PATH"
  

  按Ctrl+O后回车确认保存，再按Ctrl+X退出编辑器。

• 让配置立即生效，终端执行：

  source ~/.zshrc
  

• 验证配置结果，执行：

  qmake -v
  

  终端正常返回 Qt 5.12.0 的版本信息即配置完成。

如果不想修改全局环境变量，也可以直接给 qmake 建个软链到系统可执行目录，执行命令（替换成实际qmake路径）：

sudo ln -s /你的qmake文件的完整绝对路径 /usr/local/bin/qmake

软链创建完成后，新开终端窗口直接调用qmake即可正常使用。

内容的提问来源于stack exchange，提问作者CN_Cabbage