windows用户优先选anaconda,因其自动配置path免去手动设置;若用pip安装,则必须将python主目录及scripts目录加入系统path,否则jupyter命令无法识别。

直接说结论:Windows 用户优先选 Anaconda,省掉环境变量配置;用 pip 安装的必须手动确认 python 和 pip 在命令行可用,否则 jupyter notebook 会报“不是内部或外部命令”。
为什么 jupyter notebook 打不开?先查 python 和 pip 是否真在 PATH 里
很多人装完 pip install notebook 就运行,结果 CMD 报错:'jupyter' is not recognized as an internal or external command。这不是 Jupyter 没装好,而是系统根本找不到它——因为 pip 安装的可执行文件(比如 jupyter.exe)放在 Scripts 目录下,而这个目录没加进系统 PATH。
- 在 CMD 运行
where python和where pip,两条命令都必须返回具体路径(如C:UsersXXXAppDataLocalProgramsPythonPython310python.exe),否则 PATH 没生效 - 如果只返回“INFO: Could not find files”,说明安装 Python 时没勾选
Add Python to PATH,得重装或手动把 Python 安装目录和Scripts目录加进系统环境变量 -
Scripts路径示例:C:UsersXXXAppDataLocalProgramsPythonPython310Scripts—— 注意不是 Python 主目录,少加这一条,jupyter命令就永远找不到
Anaconda 方案:装完就能用,但别忽略默认启动位置
Anaconda 自带 Jupyter,不依赖系统 PATH,所以几乎不会出现命令未识别问题。但它有个隐蔽坑:每次启动 jupyter notebook 都从当前 CMD 所在目录打开,不是你期望的项目文件夹。
- 启动前先
cd到目标目录,再运行jupyter notebook—— 最简单、最可控 - 想永久改默认路径,必须生成并修改配置文件:
jupyter notebook --generate-config,然后编辑~/.jupyter/jupyter_notebook_config.py,取消注释并设置:c.NotebookApp.notebook_dir = 'D:/my_projects' - 注意路径写法:Windows 下用正斜杠
/或双反斜杠\,单反斜杠会导致语法错误
pip 安装后验证失败?重点看这三步
哪怕 pip install notebook 显示成功,也可能因权限、缓存或旧版本残留导致启动异常。
- 升级 pip 再装:
python -m pip install --upgrade pip,老 pip(如 20.0 以下)在 Windows 上容易卡在依赖解析 - 避免用
pip3 install jupyter notebook—— 多余的notebook会让 pip 误判为两个包,有时只装了jupyter核心但漏掉notebook前端 - 验证安装是否完整:
jupyter --version应输出类似notebook 7.2.0,如果只显示jupyter core 5.3.0,说明notebook包没装上,补装:pip install notebook
配置文件改了不生效?检查配置路径和语法
jupyter notebook --generate-config 生成的配置文件路径因系统而异,Windows 通常在 C:UsersXXX.jupyter,但如果你用的是非管理员账户或企业版系统,可能被重定向到 OneDrive 或其他位置。
- 务必用命令行运行
jupyter notebook --generate-config,别猜路径 —— 输出的第一行就是真实路径 - 编辑配置文件时,
c.NotebookApp.notebook_dir必须是字符串类型,且路径末尾不能有斜杠('D:/project/'错,'D:/project'对) - 改完保存后重启 CMD,再运行
jupyter notebook—— 配置只在新终端生效,旧终端不会自动重载
最常被忽略的点:Jupyter 启动时的当前工作目录(即 CMD 的 pwd)优先级高于配置文件里的 notebook_dir。也就是说,你在 D:data 文件夹下打开 CMD 并运行 jupyter notebook,它就会以 D:data 为根目录,哪怕配置里写了 E:work —— 这个行为不是 bug,是设计如此。











