JupyterLab（Jupyter Notebook）安装与使用

前言

目前在看《程序员数学：用Python学透线性代数和微积分》这个书，它里面的代码是在Jupyter中编写的，所以也安装下用用。

JupyterLab是一个可以同时编写文档和执行代码的软件。默认情况下它可以直接编写Markdown文档，可以编写Python代码并运行输出结果到文档。

官网地址： https://jupyter.org/

JupyterLab is the latest web-based interactive development environment for notebooks, code, and data. Its flexible interface allows users to configure and arrange workflows in data science, scientific computing, computational journalism, and machine learning. A modular design invites extensions to expand and enrich functionality.


JupyterLab是最新的基于网络的笔记本、代码和数据的互动开发环境。它灵活的界面允许用户配置和安排数据科学、科学计算、计算新闻和机器学习方面的工作流程。使用模块化的设计方便扩展和丰富功能。

Jupyter Notebook是JupyterLab的上一代版本。

安装

JupyterLab

JupyterLab依赖与Python，可以参考下面文章进行安装：
Python3基础入门： https://blog.csdn.net/Naisu_kun/article/details/129986780

安装Python后可以通过下面命令安装JupyterLab：

pip install jupyterlab

安装完成后就可以使用下面命令启动JupyterLab（在哪个目录中执行启动命令默认就会打开哪个目录）：

jupyter-lab

# 使用 ctrl + c 停止JupyterLab

默认情况下启动后会通过电脑上的默认浏览器打开界面，也可以手动打开链接：

http://localhost:8888/lab

切换中文语言

默认情况下只有界面上语言中有英文，可以在下面项目中找到可安装的语言：
https://github.com/jupyterlab/language-packs

安装中文可以使用下面命令：

pip install jupyterlab-language-pack-zh-CN

安装完成后可以在界面中进行设置：

JupyterLab desktop

JupyterLab也有桌面版软件，可以从下面项目地址Releases中进行下载安装（理论上也依赖于Python）：
https://github.com/jupyterlab/jupyterlab-desktop

切换中文语言的方式同上。

使用演示

JupyterLab的文档由一个个的Cell组成，每个Cell可以选择代码或Markdown或者其它形式。

JupyterLab最大的好处是可以在文档中写代码并运行展示结果：

同一个文档中是同一个程序上下文环境。

JupyterLab中文档部分主要使用Markdown：

可以双击运行后的Markdown进行修改。

其它补充

可以使用下面命令来查看使用帮助：

# 简易信息
jupyter-lab -h
# 完整信息
jupyter-lab --help-all

根据帮助可知 jupyter-lab 有很多选项可以用来调整启动参数，比如下面一些：
--ip='0.0.0.0' 设置服务IP地址；
--port=22333设置服务端口号；
--no-browser 不自动打开浏览器；
--allow-root 运行root用户运行；

上面方式设置都是临时性的，也可以使用配置文件来固化配置信息。使用下面命令生成配置文件：

jupyter-lab --generate-config

默认配置文件会在用户目录下 .jupyter\jupyter_lab_config.py ，其中部分配置项目如下：
c.ServerApp.ip 设置服务IP地址；
c.ServerApp.port 设置服务端口号；
c.ExtensionApp.open_browser 设置是否打开浏览器；
c.ServerApp.root_dir 设置默认文档路径；

生成配置文件后使用 jupyter-lab 命令启动服务默认就会加载配置文件中的内容。

如果地址设置为可以对外的地址的话（比如 0.0.0.0），初次通过浏览器访问时会提示输入Token或者创建新密码。

后记

JupyterLab这东西确实很不错，对于写依赖于代码的文档来说非常好用，可以避免文档内容和代码演示的割裂感。