首页 > 开发工具 > VSCode > 正文

VSCode怎么新建ipynb文件_VSCode创建和编辑Jupyter笔记本文件教程

蓮花仙者
发布: 2025-08-25 14:09:01
原创
753人浏览过
答案:在VSCode中运行Jupyter笔记本需准备Python环境、安装Python扩展并确保安装ipykernel;通过命令面板或文件菜单新建笔记本,编辑时可添加代码或Markdown单元格,运行代码后结果实时显示;通过右上角内核选择器切换Python环境,推荐为不同项目配置独立虚拟环境以避免依赖冲突;高级功能包括变量查看器、绘图查看器、单元格调试、交互式窗口及导出为多种格式,提升数据探索与调试效率。

vscode怎么新建ipynb文件_vscode创建和编辑jupyter笔记本文件教程

在VSCode里新建和编辑Jupyter笔记本,其实比你想象的要直接得多,基本上就是安装个扩展,然后点几下鼠标的事。它把Jupyter的交互式编程体验很好地融入到了一个现代化的IDE里,对我这种需要兼顾脚本开发和数据探索的人来说,简直是福音。

我个人觉得,VSCode在处理Jupyter笔记本这块,做得相当到位,几乎是零学习成本。你不需要额外去启动Jupyter服务器,也不用在浏览器和编辑器之间来回切换,所有操作都在一个界面里完成,这大大提升了工作效率。

解决方案

要开始在VSCode里玩转Jupyter笔记本,首先得确保你的环境是准备好的。这包括Python解释器、VSCode本身,以及一个至关重要的扩展:Python扩展。很多人会忘了装这个,这可是基石啊。

安装好Python扩展后,新建一个

.ipynb
登录后复制
文件就变得异常简单了。

  1. 打开VSCode
  2. 通过命令面板创建:这是我最常用的方式。按下
    Ctrl+Shift+P
    登录后复制
    (macOS上是
    Cmd+Shift+P
    登录后复制
    ),然后在弹出的搜索框里输入“Create: New Jupyter Notebook”,回车。VSCode会立刻为你打开一个全新的、空白的Jupyter笔记本。
  3. 通过文件菜单创建:你也可以点击
    文件 > 新建文件
    登录后复制
    ,然后VSCode会问你新建什么类型的文件,选择“Jupyter Notebook”即可。
  4. 直接保存为.ipynb:如果你已经打开了一个空白文件,或者在编辑一个Python脚本,想把它变成笔记本,直接另存为
    your_file_name.ipynb
    登录后复制
    ,VSCode会自动识别并以笔记本界面打开。

新建文件后,你会看到一个交互式的界面,上面有代码单元格(Code Cell)和Markdown单元格(Markdown Cell)。

  • 添加代码/Markdown单元格:在每个单元格的下方,或者在两个单元格之间,鼠标悬停时会出现“+ 代码”和“+ Markdown”的按钮,点击即可添加。
  • 编写代码:在代码单元格里输入你的Python代码。
  • 运行代码:点击单元格左侧的“运行”按钮(一个播放图标),或者选中单元格后按
    Shift+Enter
    登录后复制
    。代码会立即执行,结果会显示在单元格下方。
  • 编写Markdown:在Markdown单元格里,你可以用Markdown语法写文本、标题、列表等。编辑完成后,点击单元格右上角的“√”或者按
    Ctrl+Enter
    登录后复制
    Cmd+Enter
    登录后复制
    ),它就会渲染成富文本。
  • 选择内核:在笔记本界面的右上角,通常会显示当前激活的Python环境。点击它,你可以切换不同的Python解释器作为笔记本的运行内核。这对于管理不同的项目依赖非常重要。
  • 保存:和普通文件一样,
    Ctrl+S
    登录后复制
    Cmd+S
    登录后复制
    )即可保存你的笔记本。

整个过程非常直观,你会发现它比在浏览器里操作Jupyter Lab/Notebook还要流畅一些,毕竟是原生集成。

在VSCode中运行Jupyter Notebooks需要哪些准备工作?

说实话,很多人一开始会在这里遇到点小麻烦,觉得VSCode怎么就跑不起来Jupyter呢?其实,核心的准备工作并不复杂,但每一步都不能少,否则就可能出现“内核找不到”或者“运行不了代码”的尴尬局面。

首先,最基础的自然是Python环境。你得在系统里安装一个Python解释器,无论是从官网下载的官方版本,还是通过Anaconda、Miniconda管理的环境,都行。这是所有Python代码运行的基石。没有Python,VSCode再强大也无米下锅。

其次,也是VSCode能识别和运行Jupyter笔记本的关键,就是VSCode的Python扩展。这个扩展不光提供了代码补全、调试等功能,它还内置了对Jupyter笔记本的支持。你可以在VSCode的扩展市场里搜索“Python”,通常是Microsoft官方发布的那个。安装它,几乎就解决了90%的问题。

最后,也是很多人容易忽略的一点:你的Python环境里需要安装Jupyter相关的包。具体来说,是

ipykernel
登录后复制
。虽然Python扩展会尝试帮你管理一部分,但如果你遇到内核启动失败的问题,十有八九是当前选定的Python环境里没有安装
ipykernel
登录后复制
。解决办法很简单,打开你的终端(确保激活了你希望用于Jupyter的Python环境),然后运行:

pip install jupyter
# 或者,如果你只想最小化安装,只运行 ipykernel 也可以
pip install ipykernel
登录后复制

安装

jupyter
登录后复制
包会附带安装
ipykernel
登录后复制
以及其他一些Jupyter核心组件。如果你用的是Anaconda,通常这些都预装好了。完成这些,基本上你的VSCode就具备了运行Jupyter笔记本的所有条件。我个人的经验是,每次遇到新环境,都先检查这三点,基本不会出错。

如何在VSCode的Jupyter笔记本中管理Python环境和内核?

环境管理在数据科学和开发中是个老大难问题,尤其当你需要在不同项目中使用不同版本的库时。VSCode在这方面做得还算比较智能,但理解其背后的逻辑能帮你省去很多麻烦。

当你打开一个Jupyter笔记本时,VSCode会在界面的右上角显示当前正在使用的Python解释器或内核。这个地方非常关键。

知周AI笔记
知周AI笔记

一款本地轻量级markdown AI笔记软件

知周AI笔记 53
查看详情 知周AI笔记
  1. 选择Python解释器:在VSCode的左下角状态栏,通常会显示当前工作区激活的Python解释器。点击它,会弹出一个列表,显示VSCode检测到的所有Python环境(包括虚拟环境、conda环境等)。选择一个正确的解释器,是确保你的Jupyter笔记本能找到所需库的第一步。这个选择会影响到整个工作区,包括你的Python脚本。

  2. 选择Jupyter内核:在Jupyter笔记本界面右上角的解释器/内核选择器,是专门针对当前笔记本的。当你点击它时,VSCode会列出当前Python解释器中可用的所有Jupyter内核。如果你的Python环境里安装了

    ipykernel
    登录后复制
    ,它就会显示出来。有时候,你可能在一个环境中安装了多个
    ipykernel
    登录后复制
    (比如为不同的库集合创建的),这里就能进行切换。

    如果这里显示“未选择内核”或者你需要的内核不在列表中,很可能是因为你当前选定的Python解释器(第一步)中没有安装

    ipykernel
    登录后复制
    ,或者VSCode没有正确识别。这时,你需要回到第一步,确认Python解释器,然后确保在该解释器中运行了
    pip install ipykernel
    登录后复制

我通常的做法是,每个项目都创建一个独立的虚拟环境(

venv
登录后复制
conda env
登录后复制
),然后在这个环境中安装所有依赖,包括
ipykernel
登录后复制
。这样,在VSCode里,我只需要确保工作区选择了正确的虚拟环境,Jupyter笔记本就能自动找到对应的内核,避免了不同项目之间的依赖冲突。这虽然听起来有点繁琐,但能省去后续大量的调试时间。

VSCode的Jupyter笔记本还有哪些不为人知的高级功能?

除了基本的代码执行和Markdown渲染,VSCode的Jupyter笔记本其实藏着不少“彩蛋”,这些功能往往能大幅提升你的数据探索和调试效率。它们可能不是一眼就能看到的,但一旦用上,就真的回不去了。

  1. 变量查看器 (Variable Explorer):这是我个人觉得最实用的功能之一。在Jupyter笔记本界面左侧的侧边栏(通常是调试视图的旁边),你会看到一个“Jupyter”图标。点击它,里面就有“变量查看器”。当你运行代码单元格后,这里会实时显示当前作用域内所有变量的名称、类型和值。对于DataFrame这种复杂对象,它甚至能让你预览其内容,这在数据探索阶段简直是神来之笔,省去了大量

    print()
    登录后复制
    语句。

  2. 绘图查看器 (Plot Viewer):如果你在笔记本中生成了Matplotlib、Seaborn等库的图表,它们通常会直接显示在单元格下方。但如果你想对图表进行放大、缩小、平移,或者保存成高质量图片,直接右键点击图表,选择“在绘图查看器中打开”。它会弹出一个独立的窗口,提供更丰富的交互选项。

  3. 单元格调试 (Cell Debugging):这是一个相对高级但非常强大的功能。你可以在代码单元格中设置断点,然后点击单元格左侧的“调试单元格”按钮。VSCode会像调试普通Python脚本一样,让你单步执行单元格内的代码,查看变量状态,找出问题所在。这对于理解复杂逻辑或排查错误非常有帮助,比单纯的

    print()
    登录后复制
    高效得多。

  4. 交互式窗口 (Interactive Window):除了

    .ipynb
    登录后复制
    文件,你也可以在普通的Python脚本中,选中一段代码,然后右键选择“在Python交互式窗口中运行”。这会打开一个类似Jupyter笔记本的交互式环境,你可以逐行或逐块运行代码,并查看结果。这对于快速测试代码片段非常方便,尤其是在不希望创建完整
    .ipynb
    登录后复制
    文件时。

  5. 导出功能:VSCode支持将Jupyter笔记本导出为多种格式。在笔记本界面右上角的“更多操作”菜单(通常是三个点图标)里,你可以找到“导出”选项,将笔记本导出为Python脚本(

    .py
    登录后复制
    )、HTML、Markdown甚至PDF。这对于分享结果或将笔记本内容集成到其他工作流中很有用。

这些功能让VSCode不仅仅是一个Jupyter笔记本的查看器和编辑器,更是一个强大的数据科学工作台。花点时间探索它们,你会发现你的工作流程会变得更加高效和愉悦。

以上就是VSCode怎么新建ipynb文件_VSCode创建和编辑Jupyter笔记本文件教程的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号