Skip to content

如何安装和启动 JupyterLab

Rajiv Chandra
Name
Rajiv Chandra

Updated on

JupyterLab 是用于处理笔记本、代码和数据的现代界面。
本快速指南将帮助你在几分钟内完成 JupyterLab 的安装与启动。

1. 安装 Python 和 pip

JupyterLab 基于 Python 运行，所以需要先安装 Python（以及 pip）。

Windows

从以下地址下载最新的 Python 安装程序：
👉 https://www.python.org/downloads/ (opens in a new tab)

安装过程中，务必勾选 “Add Python to PATH” 选项。
pip 会随安装程序一起自动安装。

macOS & Linux

多数系统已预装 Python。先检查版本：

python3 --version

如果尚未安装 Python，可以通过下面方式安装：

  • macOS（Homebrew）：

    brew install python

  • Ubuntu / Debian：

    sudo apt install python3 python3-pip

2. 安装 JupyterLab

在 Python 和 pip 准备好之后，安装 JupyterLab：

pip install jupyterlab

这会安装最新的稳定版本（JupyterLab 4.x）。

3. 启动 JupyterLab

使用以下命令启动 JupyterLab：

jupyter lab

系统会自动在默认浏览器中打开界面。
现在你就可以创建笔记本、运行 Python 代码并管理文件了。

可选：创建虚拟环境（推荐）

虚拟环境可以让不同项目之间的包彼此隔离，避免相互影响。

1. 安装 virtualenv（如有需要）

pip install virtualenv

2. 创建虚拟环境

virtualenv myenv

3. 激活虚拟环境

Windows

.\myenv\Scripts\activate

macOS & Linux

source myenv/bin/activate

4. 在虚拟环境中安装 JupyterLab

pip install jupyterlab

5. 启动 JupyterLab

jupyter lab

退出虚拟环境：

deactivate

常见问题 & 进阶主题

（放在入门部分之后，以保持前半部分足够简洁易懂。）

Q1：如何使用 Conda 配置 JupyterLab？

Conda 在数据科学领域很流行，因为它可以同时管理包和环境。

1. 安装 Miniconda 或 Anaconda

2. 创建新环境

conda create --name myenv

3. 激活环境

conda activate myenv

4. 安装 JupyterLab

conda install -c conda-forge jupyterlab

5. 启动 JupyterLab

jupyter lab

Q2：如何从 Jupyter Notebook 升级到 JupyterLab？

无需卸载 Notebook，两者可以同时存在并独立使用。

使用 pip

pip install jupyterlab

使用 conda

conda install -c conda-forge jupyterlab

安装完成后，直接运行：

jupyter lab

你已有的 .ipynb 笔记本可以照常打开和使用。

Q3：（进阶）关于扩展和 JupyterLab 4.x 的新特性？

  • JupyterLab 4.x 使用了新的扩展系统，大多数扩展不再需要 Node.js。

  • 许多热门扩展（主题、Git 集成、变量查看器等）已经支持 JupyterLab 4。

  • 安装扩展示例：

    pip install jupyterlab-language-pack-<lang>
pip install jupyterlab_git

  • 查看已安装的扩展：

    jupyter labextension list

如果你还是初学者，可以先不用关注扩展，等熟悉 JupyterLab 基本用法后再尝试。

Q4：（进阶）可以用 Docker 运行 JupyterLab 吗？

可以。例如：

docker run -p 8888:8888 jupyter/base-notebook

Q5：（进阶）如何管理多个 Python kernel？

你可以为不同环境安装各自的 kernel：

pip install ipykernel
python -m ipykernel install --user --name myenv