macOS下zsh终端启动Qt Assistant提示command not found

macOS平台下Qt 5.12默认安装流程不会自动将内置组件的可执行文件路径添加到zsh的全局环境变量PATH中。Qt Creator启动时通过自身内部配置索引内置工具，不依赖系统全局路径配置，因此可正常启动；终端执行命令时仅遍历PATH中记录的目录查找可执行文件，无法定位到assistant程序时就会抛出zsh: command not found: assistant报错。
默认安装场景下，Qt Assistant的实际可执行文件路径为~/Qt5.12.0/5.12.0/clang_64/bin/assistant，若安装时自定义了安装位置，对应路径需替换为自定义目录下的5.12.0/clang_64/bin/assistant。

可根据使用场景选择以下任意一种方案：

• 单次临时调用：直接输入全路径执行即可，默认安装路径下执行命令：

~/Qt5.12.0/5.12.0/clang_64/bin/assistant

• 永久全局生效（推荐）：将Qt组件bin目录添加到zsh的PATH配置
  1. 终端执行命令编辑zsh配置文件：nano ~/.zshrc
  2. 在文件末尾追加一行配置：export PATH="~/Qt5.12.0/5.12.0/clang_64/bin:$PATH"，若自定义过Qt安装路径，将引号内的路径替换为实际的bin目录绝对路径
  3. 按快捷键Ctrl+O，回车确认文件名后保存，再按Ctrl+X退出编辑器
  4. 执行source ~/.zshrc让配置立即生效，后续直接在终端输入assistant即可正常启动程序。配置完成后可执行which assistant验证，返回对应程序路径即代表配置成功。
• 软链接方案（不修改环境变量时可选）：将assistant程序软链接到系统默认收录命令的/usr/local/bin目录下，执行命令：

sudo ln -s ~/Qt5.12.0/5.12.0/clang_64/bin/assistant /usr/local/bin/assistant

按照提示输入当前用户的开机密码即可完成配置，后续可直接在终端调用assistant命令。

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