已安装Mercury但执行mercury run报错zsh: command not found: mercury

核心原因 #

你能在Jupyter Notebook里正常导入Mercury，说明包已经成功安装，但终端找不到mercury命令，本质是pip安装的可执行文件路径没被加入系统PATH，或者Notebook使用的Python环境和终端当前环境不匹配。

分步解决方案 #

1. 定位正确的Python环境 #

先在能导入Mercury的Notebook里运行这段代码，获取当前Python解释器的完整路径：

import sys
print(sys.executable)

示例输出可能是/usr/local/bin/python3或/Users/xxx/miniconda3/bin/python。

2. 直接用对应环境执行Mercury命令 #

拿到路径后，直接通过该Python环境调用Mercury，跳过PATH问题：

# 把下面的路径替换成你刚才获取到的结果
/Users/xxx/miniconda3/bin/python -m mercury run

如果需要长期使用，也可以用该环境的pip重新安装一次，确保命令被正确注册：

/Users/xxx/miniconda3/bin/python -m pip install mercury --upgrade

3. 永久修复PATH问题 #

如果不想每次都打完整路径，把pip的可执行文件目录加入系统PATH：

1. 先找到Mercury可执行文件所在的bin目录：

   # 替换成你的Python路径
   /usr/local/bin/python3 -m pip show mercury | grep Location
   

   输出类似Location: /usr/local/lib/python3.9/site-packages，对应的bin目录就是上级的/usr/local/bin。
2. 编辑zsh配置文件~/.zshrc，添加一行：

   export PATH="/usr/local/bin:$PATH"
   

3. 执行命令让配置立即生效：

   source ~/.zshrc
   

之后就能直接用mercury run命令了。

4. 处理brew安装的问题 #

brew安装后仍找不到命令，大概率是brew的bin路径没在PATH里：

• 苹果芯片Mac（M1/M2）：检查/opt/homebrew/bin是否在PATH中，没有的话在~/.zshrc添加：

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

• Intel芯片Mac：检查/usr/local/bin是否在PATH中，没有的话同样在~/.zshrc添加：

  export PATH="/usr/local/bin:$PATH"
  

添加后执行source ~/.zshrc生效即可。

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