推荐使用 pip install notebook 而非 pip install jupyter，因后者为元包、不自带可执行入口，易导致命令未识别；需确保 python scripts/bin 目录已加入 path，并在正确环境中安装以避免内核或路径问题。
直接装 pip install jupyter 很可能失败——不是命令不对，而是你当前 Python 环境没理清、pip 版本太老、或系统 PATH 没生效。真正卡住人的从来不是“按步骤点下一步”，而是环境错位导致的 ModuleNotFoundError、jupyter notebook 命令未识别、或启动后打不开页面。
为什么 pip install jupyter 后命令不识别
最常见原因是：你用的是系统自带 Python（比如 macOS 的 /usr/bin/python3），但 pip 安装到了用户目录（~/Library/Python/x.x/bin），而该路径不在 shell 的 $PATH 里；或者你开了 conda 环境却在 base 下装，结果 jupyter 只在 base 里可用，切到其他环境就报错。
- 先确认当前 Python 和 pip 是谁：
which python3、which pip、pip --version - 如果输出路径不一致（比如
python3指向/opt/anaconda3/bin/python3，而pip指向/usr/local/bin/pip），说明环境混了，别硬装，先统一 - Windows 用户注意：安装 Python 时没勾选
Add Python to PATH，会导致 cmd 里根本找不到pip——重装 Python 并勾选，或手动把Scripts目录加进系统环境变量
conda install jupyter 和 pip install jupyter 的区别
本质是包管理逻辑不同：conda 装的是预编译二进制包，含完整依赖树（包括非 Python 库如 libz、openblas）；pip 装的是纯 Python 包，依赖系统已有底层库。对 Jupyter 来说，差别集中在三处：
-
conda install jupyter实际会装notebook、ipykernel、jupyter_client等一整套，且自动注册当前环境为内核；pip install jupyter只装notebook主体，ipykernel需单独装，否则新建 notebook 时看不到对应 Python 环境 - conda 环境下用 pip 装 Jupyter 极易出问题：比如 conda 环境 Python 是 3.11，但 pip 拿到的是旧 wheel，装完
jupyter notebook命令能运行，但打开页面后 kernel 启动失败，报ImportError: cannot import name 'soft_unicode'类错误 - 如果你只用一个 Python 环境，conda 更稳；如果你要多环境切换（比如一个跑 PyTorch 2.4，一个跑 TensorFlow 2.16），必须用 conda +
ipykernel注册，不能只靠 pip
jupyter notebook 启动后浏览器打不开 localhost:8888
这不是网络问题，而是服务端没真正起来，或前端被拦截。典型现象：终端卡在 [I 16:22:33.123 NotebookApp] Serving notebooks from local directory 不动，或一闪而过；浏览器提示“连接被拒绝”“无法访问此网站”。
- 先检查端口是否被占：
lsof -i :8888（macOS/Linux）或netstat -ano | findstr :8888（Windows），杀掉占用进程（kill -9 PID或taskkill /PID XXXX /F） - 加
--no-browser启动：jupyter notebook --no-browser，看终端是否继续输出日志。如果不输出，说明服务根本没启动成功，大概率是配置文件损坏或内核缺失 - 删掉旧配置重来：
jupyter notebook --generate-config会生成默认~/.jupyter/jupyter_notebook_config.py，但若之前手动改过，尤其加了c.NotebookApp.ip='0.0.0.0'却没配 token，会导致启动失败——删掉整个~/.jupyter目录再试 - Mac M 系列用户特别注意：如果用 Rosetta 安装的 Python，但终端是原生 Apple Silicon，架构不匹配也会静默失败。统一用原生 Python（从 python.org 下载 arm64 版）
怎么让 jupyter notebook 默认打开指定文件夹
每次启动都跳转到 ~/Downloads 或 C:UsersXXX，得手动点半天才能进项目目录？别用桌面快捷方式双击启动，那是最不可控的方式。
- 生成配置：
jupyter notebook --generate-config - 编辑配置文件：
~/.jupyter/jupyter_notebook_config.py（Windows 是%USERPROFILE%.jupyterjupyter_notebook_config.py） - 取消注释并修改这行：
c.NotebookApp.notebook_dir = '/path/to/your/project'，路径必须是绝对路径，末尾不加斜杠 - Windows 路径写成正斜杠或双反斜杠：
c.NotebookApp.notebook_dir = 'D:/my_project'或c.NotebookApp.notebook_dir = 'D:\my_project' - 改完保存，下次直接终端进任意目录执行
jupyter notebook，就会自动打开你设的路径 —— 这比每次cd /xxx && jupyter notebook少敲 5 个键，也避免误开错目录污染 .ipynb 文件
真正麻烦的不是装不上，而是装上之后 kernel 切不到目标环境、Markdown 渲染异常、或导出 PDF 报错 missing xelatex ——这些都不是安装阶段的问题，而是内核注册、扩展配置、TeX 工具链三者没对齐。动手前先想清楚：你要的到底是一个能跑代码的网页，还是一个可复现、可交付、带完整环境声明的分析文档？前者装完就能用，后者得从 conda env export > environment.yml 开始。
