Mac上jupyter notebook命令失效主因是系统Python 2.7干扰、PATH未包含用户级bin路径（如/Users/xxx/Library/Python/3.x/bin）或pip3指向错误环境；推荐用Homebrew安装Python 3自动配置PATH，或手动将对应bin路径追加至~/.zshrc并source生效。
直接装 jupyter notebook 命令在 Mac 上大概率会失败，不是因为命令写错了，而是系统自带的 Python 2.7、PATH 没配对、或 pip3 指向了错误环境。别碰 /usr/bin/python，也别试图卸载它——你真正需要的，是一个干净独立的 Python 3 + jupyter 可执行路径。
为什么 jupyter notebook 命令不识别？
Mac 系统预装 python（实际是 Python 2.7），但没预装 jupyter；而你用 pip3 install jupyter notebook 安装后，生成的可执行文件默认落在用户级路径（比如 /Users/xxx/Library/Python/3.11/bin），这个路径通常不在 $PATH 里。
常见现象：
- 终端输入
jupyter notebook，提示command not found -
which jupyter返回空，但python3 -m notebook能正常启动 -
pip3 install显示成功，却找不到命令入口
根本原因：安装过程没把 jupyter 的二进制脚本暴露给 shell。
用 Homebrew 装 Python 3 是最稳的起点
Homebrew 安装的 Python 3 自带 pip3，且自动把 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）加入 $PATH，后续所有包的可执行文件都会被正确识别。
操作步骤：
- 先装 Homebrew（如果还没装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 再装 Python：
brew install python（会同时装好python3和pip3） - 验证：
which python3应返回/opt/homebrew/bin/python3或类似路径；pip3 --version输出里应含homebrew - 然后装 Jupyter：
pip3 install jupyter notebook
这时 jupyter notebook 就能直接运行了——因为 Homebrew 的 Python 生态默认把 bin 目录纳入 PATH，无需手动追加。
如果已用官网 pkg 装过 Python 3，PATH 怎么配？
Python 官网安装包默认把可执行文件放在 /Users/xxx/Library/Python/3.x/bin，这个路径不会自动加入 $PATH，必须手动补上。
确认路径：
- 先查 Python 版本：
python3 --version（比如输出3.11.9） - 再列对应 bin 目录：
ls /Users/$(whoami)/Library/Python/3.11/bin/ | grep jupyter（能看到jupyter、jupyter-notebook等）
追加到 shell 配置：
- Mac 默认用 zsh，编辑
~/.zshrc：echo 'export PATH="/Users/$(whoami)/Library/Python/3.11/bin:$PATH"' >> ~/.zshrc - 立即生效：
source ~/.zshrc - 验证：
which jupyter应输出上述/Users/xxx/Library/...路径
注意：不要改 /etc/paths 或系统级配置，只动当前用户的 ~/.zshrc 最安全。
启动失败时的应急方案和检查点
即使 PATH 正确，也可能卡在端口占用、内核崩溃或浏览器未唤起。几个关键检查项：
- 启动失败但无报错？试试
python3 -m notebook—— 这绕过 shell 查找，直调模块，能排除 PATH 问题 - 报
Port 8888 is already in use？加参数换端口：jupyter notebook --port=8889 - 浏览器打不开 localhost？检查是否被公司代理或防火墙拦截；也可手动访问
http://127.0.0.1:8888 - 第一次启动后想改默认工作目录？运行
jupyter notebook --generate-config，编辑~/.jupyter/jupyter_notebook_config.py，取消注释并修改c.NotebookApp.notebook_dir = '/your/path'
最容易被忽略的是：Mac 新系统（尤其是 macOS Sequoia）默认启用“完全磁盘访问”限制，首次启动 Jupyter 时，系统弹窗若没点“允许”，notebook 根目录可能无法读写——去「系统设置 > 隐私与安全性 > 完全磁盘访问」里手动添加终端 App。
