Jupyterlab 安装踩坑记录

Win10系统Jupyterlab 安装踩坑记录

1. 从Jupyter Notebook 到 Jupyter Lab

对于做Python数据分析相关工作的人来说，除却庞大而厚重的PyCharm，更轻便合适的工具就是Jupyter了。对于早期使用者来说，更熟悉的工具大概是Jupyter Notebook。从Anaconda3 4.3.0版本开始，Jupyter添加了Jupyter Lab功能。Jupyter Lab可以说是Jupyter Notebook的升级强化版。除了保留了Jupyter Notebook对于代码编写和Markdown语言的良好适配之外，Jupyter Lab还提供了丰富的插件可供用户使用。笔者认为，从大趋势来说，Jupyter Lab应该会逐渐替代Jupyter Notebook。

2. 安装环境

本文讨论的安装在Windows10系统下进行，暂不讨论Linux下和MacOS下的配置方式。

3. 安装Jupyterlab之前需要安装哪些

3.1 node.js

Jupyterlab是基于网页的，需要node.js，因此需要先行安装node.js。

node.js的安装比较简单，这里是传送门：node.js安装教程

特别注意的是安装完成之后需要配置环境变量，教程里已有提及，不再赘述。

3.2 Anaconda(推荐)

安装jupyterlab之前推荐安装Anaconda，原因是从Anaconda的4.3版本开始，在navigator中自带了低版本的jupyterlab. 而如果你安装最新版的Anaconda，则不必额外安装jupyterlab，只需要直接启动即可.

4. 安装

4.1 CMD 安装

有很多博主建议在安装之前换国内源。在此也把国内源的指令贴出(以下是临时使用国内源的写法)：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple jupyterlab

但笔者不是非常建议使用国内源，原因是国内源有时会停止更新版本，导致在安装时查找不到合适的版本，或者无法安装。

安装的指令如下：

python -m pip install --upgrade pip
# 安装前先升级下pip
pip install jupyterlab
# 开始下载安装pip

4.2 Anaconda自带的Jupyter lab

打开Anaconda Navigator，可以在界面上找到jupyter lab，点击install安装，点击launch即可进入使用.（当然你还是得先安装node.js）

4.3 Anaconda较低版本时的升级

4.3.1直接升级Jupyter lab的版本

在Anaconda Prompt中

conda install jupyterlab

即可，注意，此处并不需要使用upgrade方法或update方法，直接安装则安装的就是最新的版本。

这样升级有一个好处，即Anaconda可以不必升级到高版本，保持原有的状态（少折腾），然后只升级Jupyterlab。

其他方式也可尝试，但未必成功：

conda update -c conda-forge jupyterlab

或者在navigator上使用可视化界面进行更新

4.3.2 升级Anaconda

升级Anaconda，有两种方法：

第一种：直接卸载Anaconda，下载最新的版本，安装。

这种方式显得简单粗暴，但是有时候简单粗暴，也就是简洁有效。坏处是所有通过anaconda进行配置的软件、包、虚拟环境全部需要重新部署。所以使用简单粗暴的方式之前，通常需要三思而后行。对于没有编写实质性代码，或者不介意花时间重新部署相关环境的玩家来说，隔一段时间折腾折腾，把各种软件升级到相对比较新的版本，也未必不是一件好事。

第二种：在CMD中使用命令进行升级

# conda
conda update conda
# anaconda(升级anaconda前需要先升级conda)
conda update anaconda
# anaconda-navigator
conda update anaconda-navigator

5. 保存目录设置

在CMD或Anaconda Prompt中输入

jupyter lab --generate-config

然后在此命令下方就会显示Jupyterlab配置文件所在的目录：

可以用文本编辑器打开相应路径下的配置文件：

具体编辑方法就是找到对应的参数，把参数前面的#号去掉

（这是因为这个配置文件是一个py文件，#号表示注释）

c.NotebookApp.port = 8889
# 默认是8888端口，如果有冲突可以更换端口，注意不要与其他重要的端口相冲突即可
c.NotebookApp.notebook_dir = 'D:\JupyterFiles'
# 用一个自己默认的文件夹

如此配置好之后，再打开Jupyterlab，默认的文件夹就会是指定的这个文件夹（指定还是很有必要的，之前笔者没有指定默认文件夹，系统默认在一个有巨量文件的文件夹下，结果导入时浏览器严重卡顿）

6. 插件的安装及使用

如果安装了node.js，则可以在jupyterlab的界面上安装插件。

抱歉忘记告诉大家怎么启动jupyterlab了：

在CMD或Anaconda Prompt中输入指令

jupyter lab

系统会按照默认浏览器的方式打开web界面，即jupyterlab主界面：

在左侧边栏的图标里找到“拼图”符号，打开后首先enable这个插件功能，然后在搜索框里搜索相关插件，比如我这里的jupyterlab安装了深色主题插件darcula，那我就在搜索框里搜索theme，搜索找到darcula之后，点击Install安装插件。此时jupyterlab会提醒你需要对jupyterlab进行编译，所以请暂时退出jupyterlab，在CMD或Anaconda Prompt中Ctrl+C退出jupyter服务。然后在CMD或Anaconda Prompt中输入：

jupyter lab clean
# 先clean
jupyter lab build
# 再build

build完成后再重启jupyter lab服务，则可以看到整体风格已经转换为深色的主题模式。

关于jupyterlab相关插件，还有待进一步研究。

参考内容

【1】Jupyter lab安装和基本设置

【2】Anaconda中离线升级jupyterlab并为jupyterlab安装插件