创建和编辑 Jupyter 笔记本
创建一个 Jupyter 项目
转到 。
选择一个 Jupyter 项目模板。
选择项目位置。 点击
，在 位置 字段中指定项目的目录。 项目名称将自动从指定路径中的文件夹名称派生。选择 创建Git 仓库 以 将项目置于 Git 版本控制下。
如果希望 PyCharm 将
sample.ipynb文件添加到您的项目中，请选择 创建一个简单的 Jupyter 笔记本。 此文件包含一个示例 Jupyter 笔记本，可帮助您熟悉笔记本编辑器 UI 和其他功能。如果您想继续使用 项目 venv 或 基础 conda 解释器，请选择相应的选项并点击 创建。
- 项目 venv
PyCharm 在项目文件夹中基于系统 Python 创建一个 virtualenv 环境。
- 基础 conda
PyCharm 将 conda 基础环境配置为项目解释器。
要配置其他类型的解释器或使用现有环境，请选择 自定义环境。
接下来的步骤取决于您的选择：
从环境类型列表中选择 Conda。
从列表中选择 Python 版本。
指定环境名称。
PyCharm 将检测 conda 安装。
如果 PyCharm 未能自动检测安装，请指定 conda 可执行文件的位置，或点击
以浏览。
从环境类型列表中选择 Virtualenv。
从列表中选择基础解释器，或者点击
并在您的文件系统中找到 Python 可执行文件。在 位置 字段中指定新的虚拟环境的位置，或者点击
并在您的文件系统中浏览位置。 新虚拟环境的目录应为空。如果您希望将机器上全局 Python 中安装的所有包都添加到您将要创建的虚拟环境中，请选择 从基础解释器继承包 复选框。 此复选框对应
--system-site-packages选项的 virtualenv 工具。如果您希望在 PyCharm 中创建 Python 解释器时重用此环境，请选中 使所有项目可用 复选框。
从环境类型列表中选择 Pipenv。
从列表中选择基础解释器，或者点击
并在您的文件系统中找到 Python 可执行文件。如果您已将基础二进制目录添加到您的
PATH环境变量中，则无需设置任何其他选项：pipenv 可执行文件的路径将自动检测。如果 PyCharm 未检测到 pipenv 可执行文件，请点击 通过 pip 安装 pipenv 以允许 PyCharm 自动为您安装。
或者，按照 pipenv 安装过程 发现可执行文件路径，然后在对话框中指定它。
从环境类型列表中选择 Poetry。
从列表中选择基础解释器，或者点击
并在您的文件系统中找到 Python 可执行文件。如果 PyCharm 未检测到 Poetry 安装，请点击 通过 pip 安装 poetry 以允许 PyCharm 自动为您安装 Poetry。
或者，指定 Poetry 可执行文件的位置，或点击
以浏览。要在项目目录中创建虚拟环境，请选择 创建项目内环境 复选框。
从环境类型列表中选择 uv。
从列表中选择 Python 版本。
通常，PyCharm 会检测到 uv 安装。
否则，请指定 uv 可执行文件的位置，或点击
浏览以找到它。
从环境类型列表中选择 Hatch。
通常，PyCharm 将检测 Hatch 安装。
否则，请指定 Hatch 可执行文件的位置，或点击
以浏览。请选择环境。
Hatch 环境是为各种特定于项目的任务设计的工作区。 若未明确选择环境，Hatch 将使用 默认环境。
从列表中选择基础解释器，或者点击
并在您的文件系统中找到 Python 可执行文件。
要重用现有的 conda 环境：
将 按类型分组 切换为 Conda。
指定环境名称。
PyCharm 将检测 conda 安装。
如果 PyCharm 未能自动检测安装，请指定 conda 可执行文件的位置，或点击
以浏览。从列表中选择环境。 如果您手动指定了 conda 的路径，可能需要重新加载环境。
要重用 Virtualenv、Pipenv 或 Poetry 环境：
将 按类型分组 切换为 Python。
从列表中选择 Python 可执行文件，或点击
浏览其位置。
点击 。
创建并打开 Jupyter 笔记本
要打开现有的 .ipynb 文件，请按照与其他类型文件相同的 步骤操作。 如有需要，您可以创建一个 notebook 文件。
创建一个 notebook 文件
请执行以下操作之一：
在 项目 工具窗口中右键点击目标目录，并从上下文菜单中选择 新建。
请按 Alt+Insert
请选择 Jupyter Notebook。
在打开的对话框中，输入文件名。
笔记本文件具有 *.ipynb 扩展名，并标有相应的图标 
。
将 Python 文件转换为 Jupyter notebook
在 工具窗口中右键点击该文件。
从上下文菜单中选择 。
将 Jupyter notebook 转换为 Python 文件
在 工具窗口中右键点击该文件。
从上下文菜单中选择 。
导出 Jupyter notebooks
您可以将 Jupyter 笔记本导出为多种格式：
在“项目”工具窗口中右键点击 Jupyter notebook 文件。
选择 ，然后从列表中选择格式。
编辑 Jupyter notebooks
您可以对一个单元或整个笔记本应用各种编辑操作。 按 Ctrl+A 一次以选择文本光标处的单元格，再按 Ctrl+A 两次以选择笔记本中的所有单元格。
Jupyter 笔记本的编辑器有两种模式： edit mode 和 command mode。 根据模式，您可以在笔记本单元格中编辑代码，也可以使用键盘快捷键对单元格执行特定操作。
编辑模式
要切换编辑模式，请按 Enter 或点击任意单元格。
当单元格处于编辑模式时，它在单元格内有一条带文本光标的高亮线。
在编辑模式下，您可以使用 Up 和 Down 键逐行浏览所有单元格。
命令模式
编辑单元格
新建的笔记本包含一个代码单元格。 要更改其类型，请右键单击单元格，然后从上下文菜单中选择 将单元格转换为 Markdown 或 将单元格转换为 SQL。
要编辑代码单元，只需点击它。
要编辑 Markdown 单元格，请双击它或按 Enter 并开始输入。 要预览输出，请按 Shift+Enter。
Markdown 单元格工具栏
在 Markdown 单元格中选择文本部分后，工具栏会出现。
您可以使用它应用以下格式选项：
项目
图标
快捷键
描述
文本样式
点击下拉菜单以将文本格式更改为各种标题级别。
加粗文本
Ctrl+B
将选定的文本加粗（
**text**）。斜体文本
Ctrl+I
将选定的文本设置为斜体（
_text_）。删除线
Ctrl+I
将选定的文本加上删除线。 (
~~text~~).代码
Ctrl+Shift+C
将文本格式化为内联代码。
创建链接
Ctrl+Shift+U
添加一个超链接。
无序列表
创建列表。您可以选择以下类型之一： 您可以选择以下类型之一：
无序列表
有序列表
复选列表
使用笔记本单元格
添加单元格
选择单元格
要选择一个单元格，请点击该单元格旁边的标尺。
要选择多个单元格：
点击紧靠单元格旁边的装订区域，同时按住 Shift 选择连续的单元格，或按住 Ctrl 选择非连续的单元格。
在命令模式下，按住 Shift 并按 Up 和 Down 键。
拖放单元格
要重新排列笔记本单元格：
点击并按住单元格旁侧边空白处的单元格控件。
将单元格拖动到所需位置，然后释放鼠标按钮以将其放置在高亮区域中。
复制粘贴单元格
拆分和合并单元格
要将当前单元格与下面的单元格合并，请右键点击该单元格，并从上下文菜单中选择 合并下面的单元格 命令。
同样，您可以使用相应的命令将一个单元格与所选单元格上方的单元格合并。
要将一个单元格拆分为两个单元格，请将文本光标放置在要分割的位置，然后右键点击，并从上下文菜单中选择 拆分单元格。
展开和折叠单元格
点击单元格旁边空白处的单元格控件以展开或折叠该单元格。
点击 Markdown 单元格标题旁的折叠图标以折叠或展开下方的代码单元格。 折叠的单元格数量将显示在标题下方。
注释单元格
要注释掉一个活动单元格，请切换到命令模式并按 Ctrl+/。
要注释掉多个单元格，请在命令模式下 选择它们，然后按 Ctrl+/。
删除单元格
点击
删除单元格 ，位于 单元格工具栏上。右键点击单元格并从上下文菜单中选择 。
添加单元格标签
您可以在笔记本编辑器中为每个单元分配和查看标签：
点击
，位于单元格工具栏上。从上下文菜单中选择 添加单元格标签。
输入标签并点击 确认。
要移除标签，请右键点击并选择 移除标签。
复制单元格
要复制单元格，请点击
，位于单元格工具栏上，然后从上下文菜单中选择 向下复制单元格。 新单元格将直接出现在原始单元格的下方。右键点击单元格并从上下文菜单中选择 。
使用编码辅助
您可以借助 Python 代码洞察（如语法高亮和代码补全）编辑代码单元。
自定义配色方案
您可以根据自己的偏好和习惯配置支持 Notebooks 的语法高亮。
在 设置 对话框 (Ctrl+Alt+S) 中，前往 。
选择颜色方案，接受从默认设置继承的高亮设置，或按照 颜色和字体 中的描述自定义它们。
有关调整特定笔记本元素颜色的更多信息，请参阅 Jupyter Notebooks 配色方案。