macOS运行Maestro提示“zsh: command not found”的解决办法及路径查询

一、查找Maestro的安装位置 #

Maestro在M1芯片的Mac上常见安装路径有以下几个，你可以通过以下方式定位：

• 直接执行搜索命令，快速找到可执行文件：

  sudo find / -name "maestro" -type f 2>/dev/null
  

• 常见默认路径：
  • 若通过Homebrew安装（官方脚本通常会用）：/opt/homebrew/bin/maestro
  • 用户目录下的独立安装路径：~/.maestro/bin/maestro 或 ~/.local/bin/maestro

二、添加到PATH环境变量（zsh） #

找到路径后，需要将其加入zsh的PATH中：

1. 打开zsh配置文件：

   nano ~/.zshrc
   

2. 在文件末尾添加一行（将路径替换为你找到的实际路径）：

   export PATH="$PATH:/opt/homebrew/bin"
   

   例如如果路径是~/.maestro/bin，则改为：

   export PATH="$PATH:$HOME/.maestro/bin"
   

3. 保存并退出nano（按Ctrl+O回车确认保存，再按Ctrl+X退出）
4. 刷新环境变量使修改生效：

   source ~/.zshrc
   

5. 验证是否生效：执行maestro --version，若显示版本信息则成功。

三、如果找不到Maestro，重新安装并排查问题 #

1. 重新执行安装脚本并查看详细日志，确认安装过程是否有错误：

   curl -Ls "https://get.maestro.mobile.dev" | bash -x
   

   -x参数会输出脚本执行的每一步，你能看到安装路径、是否有权限问题等细节。
2. 若普通安装失败，尝试用sudo提升权限安装：

   curl -Ls "https://get.maestro.mobile.dev" | sudo bash
   

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