如何解决M1版MacBook Air安装Jupyter后出现zsh: command not found: jupyter报错

这个报错是因为pip3安装的用户级二进制包默认路径没有被加到zsh的环境变量PATH中，M1架构Mac的pip3默认把用户安装的可执行文件放在/Users/你的用户名/Library/Python/[Python版本号]/bin目录下，zsh默认不会扫描这个路径。

解决步骤 #

• 首先确认jupyter的实际安装路径，执行如下命令：

find /Users/$(whoami)/Library/Python -name "jupyter" -type f 2>/dev/null

输出的结果就是jupyter的绝对路径，比如你可能会得到/Users/zhangsan/Library/Python/3.9/bin/jupyter，先直接用这个路径测试启动：

# 替换成你自己得到的路径
/Users/zhangsan/Library/Python/3.9/bin/jupyter notebook

如果能正常启动jupyter，就可以确定是环境变量配置问题。

• 把pip3二进制目录添加到zsh配置中，执行命令打开配置文件：

nano ~/.zshrc

在文件末尾添加如下内容，注意把3.9替换成你上一步得到的路径里对应的Python版本号：

export PATH="/Users/$(whoami)/Library/Python/3.9/bin:$PATH"

按Ctrl+O保存修改，按回车确认文件名，再按Ctrl+X退出编辑器。

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

source ~/.zshrc

• 现在直接执行jupyter notebook就可以正常启动了。

特殊情况排查 #

如果你执行第一步的find命令没有找到jupyter，说明你可能用了Homebrew安装的Python或者是在虚拟环境中安装的jupyter：

• 如果是Homebrew安装的Python，执行/opt/homebrew/bin/jupyter notebook测试，能启动的话把/opt/homebrew/bin添加到~/.zshrc的PATH里即可。
• 如果是在虚拟环境中安装的jupyter，需要先激活对应虚拟环境再执行启动命令。

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