Jupytelab 如何安装 labextension

0 背景

随着Jupyter Lab的推广，最近也是受到很多启发，于是想试一下使用Jupyter Lab，上手之后发现Jupyter Lab和Jupter Notebook的插件是分开安装的，所以需要重新安装插件包。安装过程很容易出岔子，所以留下这篇教程帮助大家，如果有疑问欢迎大家留言讨论。以下是作者的环境信息：

环境	信息
系统	Win10
软件	Anaconda3
程序	Jupyterlab 2.2.2
语言	Python 3.7.4
命令提示符	Anaconda Prompt

本教程可解决对应的问题有：

• 插件不兼容：ModuleNotFoundError: Module not found: Error: Can't resolve 'worker-loader' in 'E:\Anaconda3\share\jupyter\lab\staging\node_modules\pdfjs-dist'
  

• 无法（重新）构建：Build Recommended JupyterLab build is suggested: @jupyterlab/latex needs to be included in build @jupyterlab/toc needs to be included in build

本文写于2020年7月31日，之后随着 Jupyter Lab 和 labextension 的更新迭代，这些问题可能就不会再有了哦。

此外关于 Build 时发生的问题，大家也可以参考一下这篇文章：Jupyter Lab 升级后 Build 失败

1 环境确认

1.1 首先确保Jupyter Notebook的版本高于4.3

(base) C:\Users\admin>jupyter notebook --version
6.0.1     ←---------这个就是版本

1.2 然后请确保自己使用较高版本的Jupyter Lab，因为某些插件需要高版本（≥2.0）的Jupyter Lab。

(base) C:\Users\admin>jupyter lab --version
2.2.2     ←---------这个就是版本

1.3 版本更新

如果发现版本较低则需要更新程序（用install也可以直接更新）

conda update jupyternotebook

conda update jupyterlab

或者使用pip更新：

pip install --upgrade jupyternotebook

pip install --upgrade jupyterlab

2 安装相关库

2.1 安装 nodejs

conda install -c conda-forge nodejs

2.2 安装 yarn

使用 conda 或者 pip 安装 yarn （如果没有这一步，后面安装插件的时候很可能因为yarn库的问题报错！），原因是插件的安装过程中需要大量的运行yarn ，所以更新一下没毛病。

conda install yarn

pip install yarn

3 安装插件包

3.1 安装要点

如果此时你已经成功打开和激活了Extension Manager：

• 注意：请勿使用 Jupyter Lab 中的 Extension Manager 安装插件！
• 注意：请勿使用 Jupyter Lab 中的 Extension Manager 安装插件！
• 注意：请勿使用 Jupyter Lab 中的 Extension Manager 安装插件！

重要的事情很有必要说三遍，目前版本（2020年7月31日）的Jupyter Lab 的 Extension Manager 存在BUG，如果直接使用 Extension Manager 下载和安装很有可能出现 安装完成后，无法进行rebuild。（目前已知：latex）

3.2 安装心仪插件包

目前最安全的方法便是使用 Anaconda Prompt 手动进行安装，例如：

• jupyterlab-manager:jupyter labextension install @jupyter-widgets/jupyterlab-manager
• toc（目录）:jupyter labextension install @jupyterlab/toc
• github:jupyter labextension install @jupyterlab/github
• 很多插件的需求插件
  fasta-extension: jupyter labextension install @jupyterlab/fasta-extension
  geojson-extension: jupyter labextension install @jupyterlab/geojson-extension
  katex-extension: jupyter labextension install @jupyterlab/katex-extension
  mathjax3-extension: jupyter labextension install @jupyterlab/mathjax3-extension
  vega2-extension: jupyter labextension install @jupyterlab/vega2-extension
  vega3-extension: jupyter labextension install @jupyterlab/vega3-extension

3.3 如何找到安装包及其下载代码

既然不能直接下载，那么我们需要如何找到安装包呢？方法其实很简单

1. 通过各种推荐找到自己的心仪的包的名字
   什么？你说不知道怎么找？当然有很多文章会进行推荐啦！
   15个好用到爆炸的Jupyter Lab插件
   JupyterLab插件下载和使用
   好用到无敌的n款Jupyter 插件，建议收藏
   其次我推荐去看 Jupyter Notebook 内的 Nbextensions，里面有十分详细的各类插件介绍，有心仪的 notebook 的插件名也可以尝试。
2. 找到名字之后去 Jupyter Lab 的 Extension Manager 搜索该插件的名字
   
3. 点击进入插件的 Github 网址
   
4. 在插件的 Github 下的 Readme 内找到插件对应下载代码
   
5. 在 Anaconda Prompt中 输入相应代码，等待安装完成，启动\重启 Jupyter Lab。（如果插件不兼容，会在安装时显示，无法完成安装，就不会影响到Jupyter Lab的正常使用）
6. 使用新插件在代码海里畅游吧 😛

参考资料：
Jupyterlab官方Github
Jupyterlab官方Extensions Docs
Release 2.0.0 broken - can’t resolve ‘worker-loader’ in ‘/opt/conda/share/jupyter/lab/staging/node_modules/pdfjs-dist’ #135
Fix pdfjs-dist/webpack causing errors with certain configs #11964
Cannot find module ‘worker-loader!./build/pdf.worker.js’ from ‘webpack.js’ #11925