Jupyter Notebook 安装与使用笔记

一、什么是 Jupyter Notebook

Jupyter Notebook 是一个开源的 Web 交互式计算环境，允许你创建和分享包含代码、文本、公式、图表和可视化内容的文档（称为 notebook，后缀为 .ipynb）。

它支持多种编程语言内核，最常用的是 Python。

---

二、安装 Jupyter Notebook

方法1：通过 pip 安装（推荐）

# 先激活你的虚拟环境（如果有）
.venv\Scripts\activate

# 安装 jupyter
pip install jupyter

# 或者只安装 notebook（轻量版）
pip install notebook

方法2：通过 Anaconda 安装

如果你安装了 Anaconda，Jupyter Notebook 默认已经包含在内，无需额外安装。

---

三、启动 Jupyter Notebook

基本启动命令

# 确保在虚拟环境中
jupyter notebook

执行后会看到类似输出：

[I 14:32:05.123 LabApp] Jupyter Notebook is running at:
http://localhost:8888/?token=abc123...

浏览器会自动打开 Jupyter 界面（地址通常是 http://localhost:8888）。

其他启动方式

# 指定端口
jupyter notebook --port=9999

# 不自动打开浏览器
jupyter notebook --no-browser

# 启动 JupyterLab（更现代的界面）
jupyter lab

---

四、基本使用流程

1. 新建笔记本

• 点击右上角 New → Python 3 (ipykernel)
• 或者直接在文件列表里点 New → Notebook

2. 单元格类型

类型	用途	快捷键
Code	编写并运行代码	Y 切换到此模式
Markdown	写文本、标题、公式、图片等	M 切换到此模式

3. 常用快捷键

快捷键	功能
Shift + Enter	运行当前单元格并移到下一个
Ctrl + Enter	运行当前单元格但不移动
Alt + Enter	运行当前单元格并在下方插入新单元格
A	在上方插入一个新单元格
B	在下方插入一个新单元格
DD	删除当前单元格
Z	撤销删除
Ctrl + S	保存笔记本

4. Markdown 示例

# 一级标题
## 二级标题

**粗体文字** *斜体文字*

- 列表项1
- 列表项2

$$ E = mc^2 $$  （LaTeX 数学公式）

!图片链接

---

五、配置内核指向虚拟环境

如果你想在 Jupyter 中使用虚拟环境中的包，需要将虚拟环境注册为内核：

# 激活虚拟环境
.venv\Scripts\activate

# 安装 ipykernel
pip install ipykernel

# 注册内核
python -m ipykernel install --user --name=.venv --display-name="Python (.venv)"

之后启动 Jupyter，新建笔记本时就可以选择 Python (.venv) 内核。

---

六、常见问题

Q1: 启动时报错 "jupyter 不是内部或外部命令"

解决：确认已安装 jupyter，且虚拟环境已激活。或者用 python -m notebook 替代。

Q2: 浏览器没有自动弹出

解决：复制终端输出的 URL（含 token）手动粘贴到浏览器地址栏。

Q3: 如何退出 Jupyter

• 在终端按两次 Ctrl + C
• 或者直接关闭终端窗口

Q4: 如何查看已安装的内核

jupyter kernelspec list

Q5: 删除不需要的内核

jupyter kernelspec remove 内核名

---

七、扩展插件（可选）

安装 jupyter_contrib_nbextensions 可以获得更多实用功能：

pip install jupyter_contrib_nbextensions
jupyter contrib nbextension install --user

重启 Jupyter 后，顶部会出现 Nbextensions 标签页，可以勾选需要的插件（如代码折叠、表格美化等）。

---

八、总结

步骤	命令
安装	pip install jupyter
启动	jupyter notebook
停止	终端按两次 Ctrl+C
注册虚拟环境内核	python -m ipykernel install --user --name=环境名

写好代码后记得保存（Ctrl+S），notebook 文件（.ipynb）可以直接分享给他人或在 GitHub 上预览。