一、安装部署

1. 创建并激活 conda 环境

为了保持项目依赖的整洁和独立，我们首先创建一个新的 Conda 环境。

1
2
3
4
# 创建一个名为 jupyter_env 的环境，并指定 Python 版本为 3.12
conda create -n jupyterlab python=3.12
# 激活这个新创建的环境
conda activate jupyterlab

为什么要创建独立环境？
这可以防止不同用途项目间的库版本冲突，独立环境可以完美解决这个问题。

2. 安装 JupyterLab

在已激活的环境中，我们从 conda-forge 社区频道安装 JupyterLab，这通常能提供最新且最稳定的版本。

1
2
# 从 conda-forge 频道安装 jupyterlab
conda install -c conda-forge jupyterlab

3.启动JupyterLab

1
jupyter lab

启动后，会自动打开浏览器，可以愉快的编码了

二、必装插件

上面安装后，jupyter lab的功能还比较简陋，要想获得更优的使用体验，以下插件必不可少,安装后可以使jupyter lab拥有媲美IDE的强大功能

1.中文语言包

官方针对中文用户提供了汉化包：

1
pip install jupyterlab-language-pack-zh-CN

2.代码补全

提供代码补全、智能提示、错误检查、跳转到定义等高级 IDE 功能，可以说编程必备。这里主要用到jupyterlab-lsp这款插件，安装步骤稍多：

a.安装前端插件

1
pip install jupyterlab-lsp

b.安装后端服务

1
pip install 'python-lsp-server[all]'

c.启用LSP服务扩展

1
2
3
4
#启用服务器扩展
jupyter server extension enable --py jupyter_lsp 
#重建前端（重要！重建时间可能略长，需要耐心等待）
jupyter lab build

d.验证是否启用成功

1
jupyter server extension list

e.在‘设置’-‘编辑器设置’-‘代码补全’中进行启用

3.变量查看

添加一个变量浏览器，可以实时查看当前 Notebook 内所有变量的类型、大小和值，非常适合调试。

1
pip install lckr-jupyterlab-variableinspector

4.直接查看excel和csv文件

在 jupyterlab 中，经常会上传和导出数据，这个插件就是专门用来查看 Excel 和csv文件数据的

1
pip install jupyterlab-spreadsheet

5.目录树

原本JupyterLab在目录间跳转是一级一级进出，有了这个插件可以按照目录树的形式进行操作，极大地提升了打开不同目录下脚本的效率，让JupyterLab的文件浏览具有了和IDE一样的功能。

1
pip install jupyterlab-unfold

6.代码格式化

保存的时候自动用black和isort进行代码格式化：

1
2
3
4
# 安装插件
pip install jupyterlab_code_formatter
# 安装格式化工具
pip install black isort

7.github

jupyterlab官方出品，在 JupyterLab 界面中无缝集成 Git 版本控制功能，可以方便地进行提交、推送、拉取和分支管理。

1
pip install jupyterlab-git

8.主题插件

颜值控必备，推荐Darcula主题，目前在JupyterLab主题里面热度最高

1
pip install theme-darcula

三、高级配置

1.生成配置文件

如果您需要进行更详细的配置（例如修改默认端口、设置密码、允许远程访问等），首先需要生成一个配置文件。

1
jupyter lab --generate-config

这会在家目录下创建一个 ~/.jupyter/jupyter_lab_config.py 文件。

2.设置访问密码

为了安全，可以为 JupyterLab 设置一个访问密码。

1
jupyter lab password

根据提示输入并确认您的密码。密码的哈希值会自动保存到 jupyter_server_config.json 文件中。

3.允许远程访问

编辑 ~/.jupyter/jupyter_lab_config.py 文件，找到并修改以下行：

1
2
3
4
5
# 取消下面这行的注释，并设置为 '0.0.0.0'
c.ServerApp.ip = '0.0.0.0'

# 也可以修改默认端口
c.ServerApp.port = 8888

修改后，就可以通过服务器的 IP 地址从其他计算机访问 JupyterLab 了。