Jupyter Notebook 是一个交互式计算工具，非常适合快速开发、数据分析、可视化以及教学和分享内容。以下是完整的使用指南。

1. 安装 Jupyter Notebook

首先确保已安装 Python 环境，然后使用 pip 安装 Jupyter：

bash

pip install notebook

2. 启动 Jupyter Notebook

在项目目录中运行以下命令：

bash

jupyter notebook

默认情况下，它会启动一个本地服务器，并在浏览器中打开 Jupyter Notebook 的界面。

3. 基本操作

创建新 Notebook

1. 在界面右上角点击 New 按钮。
2. 选择 Python 内核（或其他已安装的内核）。

运行代码

• 按下 Shift + Enter：运行当前单元格代码，并跳转到下一个单元格。
• 按下 Ctrl + Enter：运行当前单元格代码，光标停留在本单元格。

添加单元格

• 代码单元格：默认是 Python 代码。
• Markdown 单元格：用于撰写文本、公式或注释（切换方式：快捷键 M）。

快捷键

• A：在当前单元格上方添加一个单元格。
• B：在当前单元格下方添加一个单元格。
• D，D（双击 D）：删除当前单元格。

4. 扩展功能

安装 Jupyter 扩展

安装 Jupyter 扩展来增强功能（如代码格式化、表格支持等）：

bash

pip install jupyter_contrib_nbextensions

jupyter contrib nbextension install --user

启用扩展：

bash

jupyter nbextension enable <extension_name>

使用交互式小工具（Widgets）

安装 ipywidgets，实现交互式控件（如滑块、按钮）：

bash

pip install ipywidgets

一个简单示例：

python

from ipywidgets import interact

def square(x):

return x ** 2

interact(square, x=(0, 100))

5. 高效开发技巧

代码自动补全

启用自动补全：

bash

pip install jupyterlab-lsp python-lsp-server

集成环境变量

在 Notebook 中读取 .env 文件：

bash

pip install python-dotenv

from dotenv import load_dotenv

load_dotenv()

import os

print(os.getenv("MY_ENV_VAR"))

集成调试器

安装调试工具：

bash

pip install ipdb

在代码中插入调试点：

python

import ipdb; ipdb.set_trace()

6. 导出 Notebook

• 导出为 HTML：用于展示代码和结果：
• 菜单栏：File -> Download as -> HTML

导出为 Python 脚本：
bash

jupyter nbconvert --to script notebook_name.ipynb

7. 与其他工具集成

与 Git 集成

将 Notebook 转换为可追踪的版本：

bash

pip install nbdime

nbdime config-git --enable

与 VS Code 集成

在 VS Code 中直接运行 Jupyter Notebook：

1. 安装扩展 Jupyter。
2. 打开 .ipynb 文件，直接进行编辑和运行。

最佳实践

1. 模块化代码：将核心逻辑提取到 .py 文件中，在 Notebook 中导入。
2. 保存关键结果：用 Markdown 单元格撰写说明文档，形成结构化报告。
3. 清理输出：在分享前，清空所有输出（菜单栏：Kernel -> Restart & Clear Output）。