新手求助:CMD运行Jupyter notebook提示‘jupyter’未被识别
报错根因
该错误是Windows命令行在当前已注册的所有可执行路径中,未找到jupyter对应的程序文件。绝大多数情况是安装Python或Jupyter时,未勾选将Python路径添加到系统环境变量Path的选项,或是Jupyter被安装到了用户目录下的Python包路径,未被系统全局识别。
解决步骤
方法1:Python模块方式启动(无需改配置,快速验证)
- 直接在CMD输入以下命令即可启动,无需配置环境变量:
python -m notebook - 若安装了Python官方的启动器,也可尝试:
py -3 -m notebook - 若上述命令可正常启动Jupyter,说明Jupyter已安装成功,仅缺少环境变量配置;若启动失败,说明Jupyter未完成安装,先执行
pip install jupyter完成安装即可。
方法2:临时添加路径到环境变量(单次CMD生效)
- 先定位Python安装路径下的
Scripts文件夹路径,常见路径如下:
全局安装路径示例:C:\Users\你的用户名\AppData\Local\Programs\Python\Python3xx\Scripts
用户级安装路径示例:C:\Users\你的用户名\AppData\Roaming\Python\Python3xx\Scripts
注:路径中的Python3xx对应你安装的Python版本,比如Python3.10就是Python310 - 在CMD中执行
set PATH=%PATH%;你刚才找到的Scripts文件夹完整路径,回车后再执行jupyter notebook即可正常启动。该配置仅对当前CMD窗口生效,关闭窗口后再次打开需要重新执行配置命令。
方法3:永久添加环境变量(全局生效)
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「用户变量」或「系统变量」列表中找到名为
Path的变量,双击打开编辑界面 - 点击「新建」,将之前找到的
Scripts文件夹完整路径粘贴进去,依次点击确定保存所有配置窗口 - 关闭之前打开的所有CMD窗口,重新打开新的CMD窗口,执行
jupyter notebook即可正常启动。
原理说明
Windows系统的命令行执行命令时,会优先在当前工作目录查找对应名称的exe/bat/com等可执行文件,查找失败后会遍历环境变量Path中存储的所有路径依次查找,所有路径都找不到对应可执行文件时就会抛出该报错。
Jupyter安装完成后,对应的可执行文件默认存放在Python安装目录下的Scripts文件夹中,仅需将该路径添加到Path环境变量,命令行即可全局识别jupyter命令。
内容的提问来源于stack exchange,提问作者modionur
相关产品推荐
相关产品推荐

