Anaconda自带Jupyter Notebook,安装时必须勾选“Add Anaconda to my PATH”,否则终端无法识别jupyter命令;未勾选则需重装或手动添加anaconda3\Scripts路径至PATH,且Scripts必须在前;启动推荐使用Anaconda Prompt,内核需单独为conda环境注册。

jupyter notebook 不是单独安装的组件,它是 Anaconda 自带的——只要装好 Anaconda,jupyter notebook 就能直接用。但很多人启动失败、找不到命令或内核不匹配,问题其实出在安装路径、环境变量和默认行为上。
安装时必须勾选“Add Anaconda to my PATH”
如果不勾选这一项,Windows 就不知道 jupyter 命令在哪,后续在任意终端输入 jupyter notebook 都会报错:'jupyter' is not recognized as an internal or external command。
常见补救方式很麻烦:要么重装 Anaconda 并勾选,要么手动把 anaconda3\Scripts 和 anaconda3 两个路径加进系统 PATH(注意顺序,Scripts 必须在前)。所以第一次安装就别跳过这步。
- 安装包运行后,在“Advanced Options”页面,务必勾选 Add Anaconda to my PATH environment variable
- 如果已安装但没勾选,推荐卸载重装——比修 PATH 更省时间
- 装完后打开新打开的 Windows Terminal 或 PowerShell,直接运行
where jupyter,应返回类似C:\Users\XXX\anaconda3\Scripts\jupyter.exe的路径
启动方式不止一种,但推荐用 anaconda prompt
直接双击开始菜单里的 “Jupyter Notebook” 图标看似最简单,但它会强制使用默认工作目录(通常是 %USERPROFILE%),且无法传参(比如换端口、禁用浏览器);而用 anaconda prompt 启动更可控。
- 在开始菜单搜索 “Anaconda Prompt”,右键选择“以管理员身份运行”(尤其当你想监听非本地 IP 时必需)
- 输入
jupyter notebook即可启动,默认打开http://localhost:8888 - 常用调试参数:
jupyter notebook --port=8889换端口;jupyter notebook --no-browser禁止自动弹窗;jupyter notebook --notebook-dir="D:\mybooks"指定根目录 - 不要用普通 cmd 或 PowerShell 启动——除非你确认 PATH 已正确配置,否则大概率报错
内核显示为 Python 3,但实际可能不是你想要的环境
Anaconda 默认只注册 base 环境的内核,名字叫 Python 3。如果你 later 创建了 conda env(比如 conda create -n py39 python=3.9),它不会自动出现在 Jupyter 的 kernel 列表里。
- 先激活目标环境:
conda activate py39 - 再注册内核:
python -m ipykernel install --user --name py39 --display-name "Python (py39)" - 重启
jupyter notebook,右上角 “Kernel → Change kernel” 就能看到新选项 - 注意:
--user参数不能省,否则可能因权限问题写入失败;--name是唯一标识符,--display-name是界面上显示的名字
启动后打不开网页?先看终端输出的最后一行
Jupyter 启动成功后,终端最后一行一定是类似这样的地址:http://localhost:8888/?token=xxx...。如果卡在 “Notebook Server Started” 就不动了,或者浏览器报 ERR_CONNECTION_REFUSED,大概率是端口被占或防火墙拦截。
- 检查是否已有其他 Jupyter 进程在跑:
tasklist | findstr jupyter,有就taskkill /f /im python.exe(谨慎执行) - 如果用的是公司/学校网络,部分防火墙会拦截 8888 端口,换端口更稳妥:
jupyter notebook --port=8890 - 终端输出里若出现
PermissionError: [Errno 13] Permission denied,说明配置文件或目录权限不对,别硬改,用jupyter --generate-config重建配置再试
jupyter notebook 启动时用的是当前 shell 的 Python 环境,而 kernel 切换用的是注册过的内核——这两者可以完全不同。搞混了就会出现代码能跑但 import 失败、包版本对不上之类的问题。


















