安装Jupyter Notebook提示'jupyter'不是内部或外部命令如何解决
问题根因
你遇到的命令找不到报错和Python版本兼容性无关,核心是多版本Python共存导致的路径混乱,具体诱因包括:
- 多版本安装时pip的安装路径不匹配:你先后安装Python3.10、3.6两个版本,执行
pip install jupyter时,jupyter会被装到当前pip关联的Python版本对应的Scripts目录下,如果你加的PATH是另一个版本的Scripts路径,自然无法识别命令。 - Python3.6安装路径找错:如果安装3.6时选择了「为当前用户安装」且没有勾选添加PATH,默认安装路径是
C:\Users\[你的用户名]\AppData\Local\Programs\Python\Python36,和全局安装的Python3.10目录位置不一致,你找不到对应结构的目录是正常的,手动加PATH时很容易加错位置。 - 过时教程误导:「Python3.6.8是最佳适配版本」是数年前的旧信息,当前稳定版Jupyter完全兼容Python3.8-3.12,刻意降版本只会增加多版本冲突的概率,没有实际意义。
- 系统预装Python抢占优先级:Windows默认会把应用商店版的Python空壳程序路径放在PATH列表靠前位置,哪怕你手动加了自己安装的Python路径,命令执行时也可能优先触发应用商店跳转,导致命令识别失败。
解决步骤
按以下顺序操作可以彻底解决问题:
- 清理混乱的环境
- 打开系统「应用和功能」面板,卸载所有已安装的Python3.6、Python3.10,以及来自微软应用商店的Python预装程序。
- 手动删除磁盘上残留的Python安装文件夹,打开系统环境变量编辑面板,删除PATH变量中所有和Python、Python36、Python310、Python Scripts相关的条目,避免残留路径干扰。
- 重新安装Python并配置路径
- 下载官方Python3.10安装包(无需安装3.6版本),安装时必须勾选安装界面底部的「Add Python 3.10 to PATH」选项,使用默认安装路径即可,不要手动修改安装位置避免后续找路径出错。
- 安装完成后新开一个命令提示符窗口,依次执行
python --version和pip --version,如果两个命令都能正常返回Python3.10的版本信息、pip路径指向刚安装的Python310目录,说明基础环境配置正确。
- 安装Jupyter并验证
- 在命令提示符中执行
pip install jupyter等待安装完成,安装过程不要中断。 - 安装完成后直接在当前命令窗口执行
jupyter notebook,如果能正常启动服务、自动打开浏览器的Jupyter页面,说明问题解决。 - 如果仍提示命令不存在,先打开Python310安装目录下的Scripts文件夹,检查是否存在
jupyter.exe文件:- 若文件存在,说明Scripts路径未正确加入PATH,将该Scripts文件夹的完整路径移动到系统PATH变量的最顶端,重启命令提示符再试即可。
- 若文件不存在,说明安装过程出错,执行
pip install --force-reinstall jupyter重新安装即可。
- 在命令提示符中执行
注意:后续如果需要安装多个Python版本,不要手动反复修改PATH,安装时可以选择不添加PATH,需要给指定版本装包时用
py -[版本号] -m pip install [包名]的格式调用对应版本的pip,避免装错路径。
内容的提问来源于stack exchange,提问作者D. Rick
相关产品推荐
相关产品推荐

