VSCode 的 Jupyter 插件整合数据分析、调试与文档写作,安装官方插件并配置含 ipykernel 的 Python 环境后即可运行 .ipynb;支持智能补全、断点调试、Markdown/LaTeX 渲染及工程化协作。

VSCode 中的 Jupyter Notebook 插件,把交互式数据分析、代码调试和文档写作全整合进一个轻量却强大的编辑器里——不用切换工具,也不用忍受传统 Jupyter Lab 的启动慢或浏览器卡顿。
安装与基础配置很直接
在 VSCode 扩展市场搜 “Jupyter”,装官方 Microsoft 出品的插件(图标是蓝白火焰)。重启后打开 .ipynb 文件就能运行单元格。Python 环境得提前配好:VSCode 左下角点击 Python 版本,选带 ipykernel 的环境(没装就终端执行 python -m pip install ipykernel,再用 python -m ipykernel install --user --name=your-env-name 注册)。
写代码像在 IDE 里一样顺手
- 支持智能补全、跳转定义、实时 lint(比如 Pylint 或 Ruff),变量名打一半就弹提示
- 按 Ctrl+Shift+P(Win)或 Cmd+Shift+P(Mac)调出命令面板,输 “Jupyter: Create New Blank Notebook” 快速新建
- 右键单元格可“在终端中运行”或“在交互窗口中运行”,适合对比不同上下文效果
- 输出区支持渲染 Markdown、LaTeX、SVG、Plotly 交互图,甚至 pandas DataFrame 表格也带排序/筛选小按钮
调试比浏览器里直观得多
在代码单元格里打个断点(行号左侧点一下),点上方绿色“运行并调试”按钮,就能单步执行、看变量值、监视表达式——和调试普通 .py 文件逻辑完全一致。特别适合查数据清洗卡在哪一行、模型参数为什么没更新这类问题。
无缝衔接工程化工作流
- 能直接 import 同项目下的 .py 模块,不用反复复制函数到 notebook 里
- 用 Export → Export to Python 一键转成脚本,清理注释和输出后就是可部署的 pipeline
- 配合 Git,notebook 的 JSON 结构虽略复杂,但用 jupyter nbconvert --to python 预处理 + 自定义 diff 工具(如 nbdime),也能看清改了哪段逻辑
基本上就这些——不复杂,但容易忽略细节。用熟了,你会觉得以前切来切去的日子真没必要。










