Jupyter安装问题排除

发布时间 2023-10-28 21:30:55作者: CD

Jupyter是一个非营利组织,旨在“为数十种编程语言的交互式计算开发开源软件,开放标准和服务”。2014年由Fernando Pérez从IPython中衍生出来,Jupyter支持几十种语言的执行环境。Jupyter项目开发并支持交互式计算产品Jupyter Notebook(文件格式是.ipynb文件)、JupyterHub和JupyterLab。

在Windows中,安装Jupyter可以非常容易,最简单的就是先安装Python, 然后执行

pip install jupyter

  

然而,在某些情况下, 安装过程可能会异常曲折, 特别是系统中曾安装过多个Python版本时。本文记录了安装过程中遇到的一些问题, 以及解决方法。

 

错误1: 成功提示某些依赖的文件在"%UserProfile%\AppData\Roaming\.."这样的路径下不存在

解决方案:据说windows app store中的Python3.10下载包时会碰到奇怪的问题, 避免此版本。另外, windows目录长度有限制, 可以通过改系统设定避免此问题, 但更推荐用户安装Python时使用客制化安装, 将Python安装到短路径中去。

 

错误2: 用pip成功安装, 但在执行"jupyter notebook"时,提示"'jupyter' is not recognized as an internal or external command"

解决方案:首先, 确认下你“成功安装”了。 运行

pip show jupyter

  如果你能看到包信息, 那么就能确认, Jupyter包确实安装好了,此时记下包的安装路径。接着, 你要检查上面看到的包安装路径是否在系统PATH环境变量中,通常在PATH环境变量中加上jupyter.exe所在目录(Scripts),就能解决此问题。

 

错误3: 我明明卸载了所有之前已安装的Python, 并重新安装Python到"D:\Python312"目录了, 为啥jupyter还是被安装到了"%UserProfile%\AppData\Roaming\Python\Scripts"这样的目录?

解决方案:此问题, 还是与Python的历史安装有关。通过如下命令

where pip

  可以查看你的pip所在目录, 它会将你的jupyter也安装到这个目录。如果pip的位置指向"%UserProfile%\AppData\Roaming\Python\Scripts"这样的目录,而你又不想再使用这个目录, 可以将此目录从PATH中去除(在某些电脑中无效?)或者将此目录更名(比如更名Python为Python_Isolate)。

"%UserProfile%\AppData\Roaming\Python\Scripts"这样的目录, 这是"user installation"目录,也是Python默认安装目录。至于, 为何pip安装的新包会出现在这样的目录, 可能的原因有:

1.  安装Python时, 没有勾选为所有用户安装的选项

2. 由于之前安装过Python,此目录在系统PATH环境变量中

3. pip安装包时用了用户安装选项,比如pip install --user <package_name>

4. pip安装时, 对目标目录无写权限, 系统将安装目录自动更改到"user installation"目录。只在某些windows环境中出现此情况, 可以用administrator执行命令行来解决此问题

5. 其他情况。 这种情况可以通过where pip来排查, 临时解决方法是将目录更名(比如更名Python为Python_Isolate)