最稳的Jupyter安装方式是直接用pip install notebook,而非Anaconda或pip install jupyter;需先确保Python和pip已正确加入PATH并能正常输出版本号,再安装notebook核心包,启动失败时优先升级pyzmq和pywin32,必要时新建虚拟环境。

直接装,别绕路——用 pip 是最稳、最轻量、最可控的方式。Anaconda 虽然自带,但体积大、环境杂、更新慢,除非你明确需要它附带的 180+ 科学包,否则不推荐作为 Jupyter 的安装入口。
确认 Python 已正确安装并加入 PATH
这是最容易卡住的第一步。很多“jupyter 不是内部或外部命令”错误,根源不在 Jupyter,而在 Python 路径没配好。
- 打开 CMD,运行
python --version和pip --version,两者都必须能正常输出版本号 - 如果报错
'python' 不是内部或外部命令,说明 Python 没加进系统 PATH —— 重装 Python 时务必勾选 Add Python to PATH;若已装过,手动把 Python 安装目录(如C:UsersXXXAppDataLocalProgramsPythonPython311)和 Scripts 子目录(如C:UsersXXXAppDataLocalProgramsPythonPython311Scripts)加进系统环境变量 - 改完 PATH 后,**必须新开一个 CMD 窗口**再测试,旧窗口不会自动继承新 PATH
用 pip 安装 notebook,不是 jupyter
注意命令名:pip install notebook,不是 pip install jupyter。后者会装一整套(jupyter-console、jupyter-server 等),而日常写代码只需要 notebook 这个核心包。
- 运行
pip install notebook(推荐加国内镜像提速):pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ notebook - 如果提示
WARNING: Retrying (Retry(total=4, connect=None, read=None, ...)),说明网络不稳定,换镜像源或重试 - 安装完成后,直接运行
jupyter notebook—— 它会自动在默认浏览器打开http://localhost:8888,不需要额外配置启动服务
启动失败?先看 CMD 里有没有报 ImportError 或 DLL 错误
常见现象:CMD 打印一堆 traceback,最后卡在 ImportError: DLL load failed 或 ModuleNotFoundError: No module named 'zmq'。这不是 Jupyter 本身的问题,而是底层依赖损坏。
- 优先尝试升级
pyzmq和pywin32:pip install --upgrade pyzmq pywin32 - 如果仍失败,说明当前 Python 环境有冲突(比如混用了 conda 和 pip 安装的包),建议新建干净虚拟环境:
python -m venv myenv→myenvScriptsctivate→ 再pip install notebook - 不要盲目卸载重装 Python —— 大多数 DLL 问题通过重装关键依赖就能解决,重装 Python 反而可能加剧 PATH 混乱
想换默认工作目录?改配置文件,别硬记路径
Jupyter 默认在 CMD 当前目录启动,很多人不知道怎么固定到某个文件夹(比如 D:
otebooks),结果每次都要 cd 进去。
- 先生成配置:
jupyter notebook --generate-config,它会告诉你配置文件位置(通常是C:UsersXXX.jupyterjupyter_notebook_config.py) - 用记事本或 VS Code 打开该文件,搜索
c.NotebookApp.notebook_dir,去掉行首#注释,并填入绝对路径:c.NotebookApp.notebook_dir = 'D:\notebooks'(注意双反斜杠或原始字符串r'D: otebooks') - 保存后,下次直接运行
jupyter notebook就会默认打开这个目录 —— 不用每次都 cd,也不用写启动脚本
真正麻烦的从来不是安装命令本身,而是 Python 环境状态不可见、PATH 变更不生效、依赖链断裂却无提示。盯住 CMD 输出的第一行错误,而不是浏览器打不开就以为是 Jupyter 没装好。


















