安装hiptest-publisher后执行命令提示zsh: command not found如何解决

问题根因 #

zsh: command not found: hiptest-publisher报错核心原因是Ruby gem安装的第三方工具可执行文件路径，没有被添加到zsh的环境变量PATH中，终端无法找到对应命令。

分步解决方案 #

• 第一步：确认hiptest-publisher已成功安装
  执行命令：

gem list | grep hiptest-publisher

如果有对应版本输出说明安装成功，无输出则重新执行安装命令，若出现权限报错可临时加sudo，更推荐使用rbenv/rvm管理用户级Ruby环境避免系统权限问题。

• 第二步：查找gem可执行文件存放路径
  执行命令：

gem environment | grep "EXECUTABLE DIRECTORY"

复制输出的路径（示例：/Users/你的用户名/.gem/ruby/3.1.0/bin）。

• 第三步：将路径添加到zsh配置
  执行命令打开zsh配置文件：

vim ~/.zshrc

在文件末尾添加一行内容，将刚才复制的路径替换到对应位置：

export PATH="你复制的gem可执行目录路径:$PATH"

• 第四步：让配置生效
  执行命令重载zsh配置：

source ~/.zshrc

验证 #

执行命令验证是否可正常识别：

hiptest-publisher --version

输出版本号即修复完成，可正常执行测试结果推送命令。

特殊场景排查 #

• 若使用rbenv管理Ruby版本：安装gem后执行rbenv rehash刷新可执行文件映射即可。
• 若使用rvm管理Ruby版本：执行rvm list确认当前使用的Ruby版本，和安装hiptest-publisher时的版本一致即可。

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