Jupyter Notebook VS Code
VS Code 中使用 Jupyter Notebook VS Code(全称 Visual Studio Code)是一款由微软推出的免费、开源、跨平台的代码编辑器。 在 VS Code 中使用安装扩展来使用 Jupy
VS Code(全称 Visual Studio Code)是一款由微软推出的免费、开源、跨平台的代码编辑器。
在 VS Code 中使用安装扩展来使用 Jupyter Notebook,VS Code 强大的代码补全功能与 Jupyter 的交互式体验可以完美结合。
如果你还没有安装 VS Code,请前往其官方网站下载并安装,安装过程非常简单,一路点击 "下一步" 即可。
如果不了解 VS Code,可以参考我们的 VSCode 教程。
打开 VS Code,点击左侧活动栏的 Extensions(扩展) 图标(快捷键 Ctrl+Shift+X),搜索并安装 "Jupyter" 插件(由 Microsoft 提供),安装此插件会自动安装 Python 扩展。

核心功能与操作指南
创建你的第一个 Jupyter Notebook
现在,让我们创建一个全新的 Jupyter Notebook 文件 (.ipynb)。
新建文件:直接新建一个以 .ipynb 结尾的文件即可。

也可以通过命令面板创建:
- 在 VS Code 中,按
Ctrl+Shift+P打开命令面板(这是一个万能搜索框)。 - 输入
Jupyter: Create New Jupyter Notebook并选择它。 - VS Code 会自动创建一个名为
Untitled-1.ipynb的新文件,并以笔记本界面打开。你会看到第一个单元格已经准备就绪。

配置运行环境(Kernel)
在运行代码前,你需要告诉 VS Code 使用哪个 Python 解释器:
-
点击编辑界面右上角的 "Select Kernel"(选择内核)。

-
在弹出的列表中,选择你安装好的 Python 版本或 Anaconda 环境(例如 Python 3.x.x 或 base (conda))。

- 注意:如果是第一次运行,VS Code 可能会提示你安装 ipykernel 包,点击"安装"即可。
然后,就可以开始写代码运行了:

单元格运行与管理
运行代码单元格
- 单块运行:点击单元格左侧的 播放图标 (▶)。
- 快捷键方案:
Ctrl + Enter:运行当前单元格。Shift + Enter:运行当前单元格并跳转/选择下方单元格。Alt + Enter:运行当前单元格并在下方插入新单元格。

- 多块运行:使用顶部工具栏的"双箭头"图标 Run All 运行全文;或在特定单元格处选择 Run Above(运行上方所有)或 Run Below(运行下方所有)。
- 按章节运行:在"大纲 (Outline)"视图中,可以点击章节标题旁的按钮,运行该 Markdown 标题下的整组单元格。

单元格模式
VS Code 中的单元格有三种状态,通过左侧的垂直条标识:
- 未选中:无垂直条。
- 命令模式 (Command Mode):垂直条为实心,此时可执行键盘命令(如删除、复制)。
Enter进入编辑模式;Esc返回命令模式。A在上方插入单元格;B在下方插入。D, D(连按两次)删除单元格;Z撤销删除。
- 编辑模式 (Edit Mode):垂直条为实心且单元格带边框,此时可输入代码。
格式切换
- 命令模式下:按
M切换为 Markdown(文档),按Y切换为 Code(代码)。
文件操作与导航
- 保存:
Ctrl + S。 - 导出:点击工具栏的
...> Export。支持导出为.py脚本、HTML 或 PDF(注:PDF 导出需安装 TeX 环境)。 - 大纲导航:通过侧边栏的 Outline 视图快速跳转。默认仅显示 Markdown 标题,可在设置中开启
Notebook > Outline: Show Code Cells以显示代码块。 - 行号控制:命令模式下,按
L切换单格行号,按Shift + L切换全文行号。

数据科学增强工具
变量浏览器与数据查看器
点击工具栏的 Variables 图标,可在底部打开变量面板。
- 查看详情:双击变量或点击旁边的图标,可进入 Data Viewer(数据查看器)。
- 筛选数据:在列顶部的文本框输入内容可搜索;输入
=可精确匹配;支持正则过滤。


绘图保存
鼠标悬停在生成的图表(如 matplotlib 产出)上,点击右上角的 Save 图标即可保存为图片。

调试与进阶
调试功能 (Debug)
- 逐行运行 (Run by Line):点击单元格工具栏的图标,可不被打扰地单步执行代码。

- 完全调试:在单元格左侧设置断点,选择
Run按钮旁的 Debug Cell。
远程连接
若需使用远程服务器的算力:
- 点击右上角 Kernel Picker(内核选择器)。

- 选择 Existing Jupyter Server。

- 输入带有
?token=的服务器 URL 即可连接。
差异比对 (Diff)
由于 .ipynb 本质是 JSON,VS Code 提供了可视化比对工具。你可以清晰地看到输入、输出或元数据的具体变化,而不需要去阅读混乱的原始代码。

