You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

新手求助: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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 07:45:03