PyCharm 2026.2 Help

编辑器基础

PyCharm 编辑器是 IDE 的主要组成部分,您用它来创建、阅读和修改代码。

编辑器由以下区域组成:

编辑器详细信息
  1. 滚动条显示当前文件中的错误和警告。

  2. 面包屑 可帮助您在当前文件的代码中导航。

  3. 装订区域显示行号、注释以及与上下文相关的操作图标。

  4. 选项卡 显示当前打开文件的名称。

导航

您可以使用各种快捷键在编辑器与不同的工具窗口之间切换、更改编辑器大小、切换焦点,或返回到原始布局。

最大化编辑器窗格

  • 在编辑器中,按 Ctrl+Shift+F12。 PyCharm 会隐藏除活动编辑器之外的所有窗口。

    您也可以最大化拆分屏幕。 在这种情况下,活动屏幕将被最大化,其他屏幕会被移到一旁。

将焦点从窗口切换到编辑器

  • 按 Escape。 PyCharm 会将焦点从任意窗口移到活动编辑器。

从命令行终端返回到编辑器

  • 按 Alt+F12。 PyCharm 会关闭终端窗口。

  • 如果在切换回活动编辑器时需要保持终端窗口打开,请按 Ctrl+Tab。

跳转到上次活动窗口

  • 按 F12。

使用切换器进行导航

  1. 要使用切换器在已打开的文件与工具窗口之间跳转,请按 Ctrl+Tab。

  2. 按住 Ctrl 以保持切换器弹出窗口处于打开状态。

  3. 按 Tab 在各元素之间移动。 按 Backspace 从列表中移除所选文件并在编辑器中将其关闭。

更改 IDE 外观

您可以在方案、键位映射和视图模式之间切换。

  1. 按 Ctrl+`。

  2. 在 切换 菜单中,选择所需选项并按 Enter。 使用相同的快捷键 Ctrl+` 撤销您的更改。

您可以在 设置 | 编辑器 | 颜色方案 中调整配色方案设置,包括针对视力障碍人士的 高对比度 配色方案。 要调整键位映射设置,请转到 设置 | 键位映射。

  • 按 Alt+Home。

滚动条

在编辑器中处理代码时,PyCharm 会在滚动条上显示代码分析结果,其中包括错误和警告。 您可以检查代码是否存在问题,并快速导航至这些问题。

滚动条顶部有 检查 小部件,可为您简要汇总代码问题。 点击该小部件,在 问题 工具窗口中获取每个已检测到问题的更多信息。

文件的代码分析摘要

更多信息,请参见 当前文件的即时分析。

滚动条上的条纹表示 PyCharm 发现问题的位置。 将鼠标悬停在条纹上可查看描述问题的工具提示,或点击该条纹以快速导航。

在处理文件时看到许多条纹是正常的。 随着您完成代码,许多错误、警告和建议最终都会得到解决。 如果在您认为代码已完成时仍然存在错误,建议在编译项目之前先排查并解决这些错误。

条纹的不同颜色表示问题的严重程度,从用红色标记的错误到用蓝色标记的 TODO 注释,但如有需要,您可以更改显示的颜色。 更多信息请参阅 更改检查严重性。

使用镜头模式

镜头模式可让您无需滚动即可预览代码。 默认情况下,将鼠标悬停在编辑器滚动条上即可使用。 该预览显示代码高亮,包括警告和错误,这在处理大型文件时非常有用。

镜头模式
  • 要禁用镜头模式,请右键点击编辑器滚动条,并在上下文菜单中清除 在滚动条悬停时显示代码透镜 复选框。

  • 或者,在 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 | 外观 ,并清除 在滚动条悬停时显示代码透镜 复选框。

迷你地图

缩略图可以提供当前打开文件的缩放概览,方便在大型文件中导航并理解代码结构。

迷你地图

启用缩略图

  • 转到 设置 | 编辑器 | 缩略图显示栏 Minimap ,然后选中 启用 复选框。

    启用缩略图
  • 或者,点击编辑器工具栏中的 更多 ,然后选择 显示缩略图显示栏。

    显示缩略图显示栏
  • 灰色矩形(缩略图)表示当前在编辑器中可见的文件部分。 拖动缩略图即可滚动文件。

    缩略图
  • 点击缩略图的任意位置,可以跳转到文件对应的位置。

使用缩略图查看代码结构

  1. 在 设置 | 编辑器 | 缩略图显示栏 Minimap 中,选中 显示结构悬停 复选框。

  2. 将鼠标悬停在缩略图内的类、函数或其他支持的结构元素上。 缩略图会高亮显示其边界,并显示其名称和图标。

    查看代码结构

编辑器选项卡

您可以关闭、隐藏和分离编辑器选项卡。 每次您打开一个文件进行编辑,都会在活动编辑器选项卡旁添加一个以其名称命名的选项卡。

要配置编辑器选项卡的设置,请使用 设置 | 编辑器 | 常规 | 编辑器选项卡 页面。 或者,右键点击某个选项卡,并在选项列表中选择 配置编辑器标签页…。

打开或关闭选项卡

  • 要关闭所有已打开的选项卡,请在主菜单中选择 窗口 | 编辑器选项卡 | 关闭所有选项卡。

  • 要关闭所有非活动选项卡,请按 Alt 并在活动选项卡上点击 Close 按钮。 在这种情况下,只有活动选项卡保持打开。

  • 要关闭除活动选项卡和 固定的选项卡 之外的所有选项卡,请右键点击任意选项卡并选择 关闭其他标签页。

  • 要仅关闭活动选项卡,请按 Ctrl+F4。 您也可以在选项卡上的任意位置点击鼠标滚轮按钮以将其关闭。

  • 要重新打开已关闭的选项卡,请右键点击任意选项卡,并在上下文菜单中选择 重新打开关闭的标签页。

  • 要打开一个新选项卡并将其放在所有已打开选项卡的右侧,请在 选项卡设置 中选择 在结尾打开新标签页。

复制路径或文件名

  1. 右键点击该选项卡。

  2. 从打开的列表中,选择 复制路径/引用…。

  3. 在打开的列表中,选择您的 复制选项。

    复制路径

    PyCharm 会将该项复制到剪贴板,您可以在需要的任何位置粘贴(Ctrl+V)。

移动、移除或排序选项卡

  • 要移动或移除选项卡上的 Close 按钮 图标,请在 设置 对话框(Ctrl+Alt+S )中转到 编辑器 | 常规 | 编辑器标签页 ,并在 关闭按钮位置 字段中选择相应的选项。

  • 要将编辑器选项卡放置在编辑器框架的其他位置或将其隐藏,请右键点击某个选项卡并选择 配置编辑器标签页… 以打开 编辑器选项卡 设置。 在 外观 部分,从 标签页位置 列表中选择相应的选项。

  • 要查看隐藏的编辑器选项卡,请点击编辑器中最后一个可见选项卡旁的 隐藏选项卡图标。

  • 要按字母顺序对编辑器选项卡进行排序,请右键点击某个选项卡并选择 配置编辑器标签页… 以打开 编辑器选项卡 设置。 在 选项卡顺序 部分,选择 按字母顺序对标签页排序。

固定或取消固定选项卡

您可以固定活动编辑器选项卡,这样在达到选项卡限制或使用 关闭其他标签页 命令时,该选项卡仍会保持打开。

  • 要固定或取消固定活动选项卡,请右键点击该选项卡,并在上下文菜单中选择 固定选项卡 或 取消固定标签页。

  • 要关闭除固定的选项卡之外的所有选项卡,请右键点击任意选项卡并选择 关闭所有未固定标签页。

  • 要为 固定选项卡 操作分配键盘快捷键,请在 设置 对话框(Ctrl+Alt+S )中转到 键位映射 ,找到 固定活动标签页 操作,右键点击它,选择 添加键盘快捷键 ,然后按下您要使用的按键组合。

  • 要将固定的选项卡保持在左侧,请在 设置 对话框(Ctrl+Alt+S )中转到 高级设置 ,找到 编辑器选项卡 部分,并选择 将固定的标签页保留在左侧 选项。

分离选项卡

当您分离一个选项卡时,该选项卡会在单独的窗口中打开,该窗口将专用于此分离的选项卡。

如果您尝试将另一个选项卡从主框架分离,它将会在自己的独立窗口中打开。 您可以将新分离的选项卡放置在任意位置(左侧、右侧、底部或顶部)。 您也可以将不同的工具窗口拖动到该框架中。

  • 将所需的选项卡拖到主窗口之外。 如果您想重新附加该选项卡,请将其拖回主窗口之上,或点击 Dock Dock。

  • 要分离活动选项卡,请按 Shift+F4。

  • 您也可以使用 Alt+mouse 执行相同操作。

在选项卡之间切换

  • 要在选项卡之间切换,请按 Alt+Right 或 Alt+Left。

  • 您还可以在最近查看的选项卡或文件之间切换。

    在编辑器中,按 Ctrl+Tab 并按住 Ctrl 以保持 切换器 窗口处于打开状态。 使用 Tab 选择所需的选项卡或文件。

为已打开的选项卡分配快捷键

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 键位映射。

  2. 在目录列表中,点击 其他 ,并选择您要为其添加快捷键的目录。 可分配快捷键的选项卡最多为 9 个。

    为选项卡添加快捷键

更改默认选项卡限制

PyCharm 会限制您在编辑器中同时打开的选项卡数量(默认选项卡限制为 10)。

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规 | 编辑器标签页。

  2. 在 关闭策略 部分,根据您的偏好调整设置,然后点击 确定。

在预览选项卡中打开文件

预览选项卡允许您在单个选项卡中逐个查看文件,而无需为每个文件打开新选项卡。 如果您需要查看多个文件且不想超过选项卡限制,这将非常有用。

  1. 在 项目 工具窗口(Alt+1 )中,点击 并选择 行为 | 启用预览选项卡。

    您还可以在 设置 | 常规 | 编辑器选项卡 | 打开策略 中启用预览选项卡。

  2. 在 项目 工具窗口(Alt+1 )中,选择一个尚未在其他选项卡中打开的文件。

    文件名称以斜体显示,以指示预览模式。 您选择的任何其他文件都会在预览选项卡中替换先前的文件。

    开始编辑该文件,或双击该文件的选项卡以退出预览模式,并将预览选项卡转换为常规选项卡。

    预览选项卡

    请注意,启用预览选项卡时,将忽略 点击打开文件 选项。 双击文件,将其在常规选项卡中打开。

显示多个选项卡

当您打开的选项卡多于屏幕可容纳的数量时,您可以将其放在一行或多行中。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 编辑器 | 常规 | 编辑器标签页。

  2. 在 显示选项卡位置 部分,选择以下选项之一:

    • 单行,如果选项卡放不下 :将所有选项卡放在一行中,如果选项卡放不下:

      • 滚动选项卡栏 :将鼠标悬停在选项卡行上,并使用出现的滚动条或鼠标滚轮滚动选项卡。 或者,使用右侧的下拉列表(显示隐藏的选项卡 )打开视口外的选项卡。

      • 压缩选项卡 :压缩选项卡,使其适应屏幕。

    • 多行 :将选项卡放在多行中。

    滚动选项卡
    压缩选项卡
    多行

更改选项卡字体大小

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 外观&行为 | 外观。

  2. 在 大小 字段中,指定字体大小并点击 确定 以保存更改。

    请注意,字体大小不仅适用于选项卡,还会影响工具窗口。

面包屑显示从插入符号所在的代码元素到文件根元素的路径。 它们有助于跟踪您在 文件结构 内的位置。

面包屑的每个部分都可单击,从而便于导航到父级代码元素。 如需更多信息,您还可以使用在将鼠标悬停于面包屑部分时出现的工具提示。

使用面包屑进行导航

编辑器面包屑
  • 在编辑器中点击某个面包屑以导航到所需的代码元素。

  • 要更改面包屑的位置,请在编辑器中右键点击某个面包屑,转到 外观 | 路径导航 ,并选择新位置:编辑器顶部或底部。

    面包屑外观设置
  • 要编辑面包屑的设置、为其他语言启用或禁用面包屑,或更改其外观,请按 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 常规 | 路径导航。

    清除 显示路径导航 选项以在编辑器中隐藏面包屑。

拆分屏幕

PyCharm 提供多种可用于拆分编辑器屏幕的操作,您可以在主菜单、上下文菜单、编辑器或 项目 工具窗口中调用这些操作。

  • 在编辑器中,右键点击所需的编辑器选项卡,然后选择如何拆分编辑器窗口(向右拆分 或 向下拆分)。 PyCharm 会创建编辑器的拆分视图,并根据您的选择进行放置。

  • 或者,转到 窗口 | 编辑器标签页 ,并选择 拆分并右移 或 拆分并下移 选项。

  • 您可以垂直或水平拖动选项卡以拆分编辑器,并将选项卡拖回以取消拆分屏幕。

  • 您可以在编辑器中将文件打开到右侧拆分区。

    在 项目 工具窗口中,右键点击该文件,并在上下文菜单中选择 在右侧拆分中打开。 PyCharm 会在编辑器右侧的拆分区中打开该文件。

    如果存在两个拆分且焦点位于左侧拆分区,文件将会在现有的右侧拆分区中打开。 如果焦点位于右侧拆分区,文件将会在下一个右侧拆分区中打开。

  • 您可以在拆分视图之间移动文件。 在编辑器中右键点击所需的文件选项卡,并在上下文菜单中选择 移动到对侧组 或 在对侧组中打开。

  • 您可以一次性关闭所有已打开的工具窗口,从而扩大拆分视图区域。 将焦点置于某个编辑器选项卡,并按 Ctrl+Shift+F12 ,或双击该选项卡。 PyCharm 会隐藏所有已打开的工具窗口,因此所有空间将由拆分视图共享。

  • 您可以使用 Equalize proportions in nested splits 选项,将编辑器多次等比分割。

  • 要取消拆分屏幕,请在上下文菜单中选择 取消拆分 ,或选择 取消全部拆分 以取消拆分所有拆分窗格。

移动拆分视图

  1. 将插入符号置于所需的拆分窗格内。

  2. 在主菜单中,转到 窗口 | 编辑器标签页。

  3. 在选项列表中,选择以下选项之一:

    • 将编辑器拉伸到顶部

    • 将编辑器拉伸到左侧

    • 将编辑器拉伸到底部

    • 将编辑器拉伸到右侧

    您可以为每个选项 分配快捷键 ,并使用键盘拉伸拆分窗格。

    要在拆分窗格之间移动,请转到 窗口 | 编辑器标签页。 在选项列表中,分别选择 转到下一个分割器 ⌥ ⇥ 或 转到上一个拆分器 ⌥ ⇧ ⇥。

快速弹出窗口

描述

操作/访问

提示

查看符号(标签、class、方法/函数、字段等)的 快速定义。

Ctrl+Shift+I

在弹出窗口中显示该符号的定义。 您可以点击 固定按钮 图标,在 查找 工具窗口中打开该项的定义及其用法。

查看代码元素或文件的 快速文档。

Ctrl+Q

在弹出窗口中显示文档。

您可以按两次 Ctrl+Q ,在 文档注释 工具窗口中打开该弹出窗口。 再次按下相同的快捷键可切换回弹出窗口。

如果您想更改弹出窗口中文本的字体大小,请点击 设置 图标并指定新的字体大小。

对于代码元素,您还可以查看 外部文档。 在快速文档弹出窗口中,点击 上一条 或按 Shift+F1。

在查找类 Ctrl+N 时,您可以为列表中显示的任何类调用快速文档弹出窗口。 要将焦点切换到该弹出窗口,请按相同的快捷键。

查看 上下文信息。

Alt+Q

当当前方法或类的声明不可见时予以显示。

查看插入符处错误或警告的 描述。

Ctrl+F1

点击代码分析标记以查看检测到的错误列表。 使用 F2 或 Shift+F2 导航到下一个或上一个错误。

将工具提示文本复制到剪贴板。

按住 Alt (在 Linux 上,按住 Ctrl+Alt )并点击该工具提示。

查看代码元素的所有 用法。

Ctrl+Shift+F7

要控制用法高亮,请转到 设置 | 编辑器 | 代码编辑 ,并在 插入符号移动时高亮 中选择或清除 在插入符处高亮显示元素的用法 选项。

如果打开省电模式(文件 | 省电模式 ),则不会高亮显示用法。

字体

您可以配置并更改字体、其大小以及连字。 字体大小的更改可以仅应用于一个编辑器选项卡,也可以全局应用。

配置字体和连字

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 字体。

  2. 从列表中选择所需的字体,指定其 大小 和 行高。 您还可以启用连字并配置排版设置。

  3. 点击 确定 以保存更改。

在编辑器中更改字体大小

  1. 在 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 (鼠标控制 部分)。

  2. 选择 使用 Ctrl+鼠标滚轮更改字体大小 选项。

  3. 返回编辑器,按住 Ctrl ,并使用鼠标滚轮调整字体大小。

在所有选项卡中增大或减小字体大小

  • 在编辑器中,按 Alt+Shift+. 以全局增大字体大小,并按 Alt+Shift+Comma 以减小字体大小。

    PyCharm 会在编辑器底部显示一个缩放指示器,显示当前字体大小和默认值,您可以恢复到默认值。

  • 缩放指示器默认启用。 要将其禁用,请打开 设置 对话框(Ctrl+Alt+S ),转到 高级设置 ,并在 编辑器 部分清除 显示缩放指示器 选项。

实用的编辑器配置

您可以使用 编辑器 部分的 设置 对话框(Ctrl+Alt+S )来定制编辑器的行为。

请查看以下常用配置:

配置代码格式化

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 代码风格。

  2. 从语言列表中选择合适的语言,并配置制表符和缩进、空格、换行和大括号、硬边距和软边距等设置。

为不同语言和框架配置配色方案设置

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 配色方案。

  2. 打开 配色方案 节点并选择所需的语言或框架。 您还可以选择 通用 选项,以配置常规项(例如代码、编辑器、错误和警告、弹出窗口和提示、搜索结果等)的配色方案设置。

配置代码补全选项

  • 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规 | 代码补全 | 弹出窗口。 在这里,您可以配置区分大小写的补全、自动显示选项、代码排序等。

配置插入符号位置

  • 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规。 在 虚拟空格​ 部分,配置插入符号位置选项。

    选择 允许将插入符号放置在行尾之后 选项以将插入符号放置在下一行,并与上一行的末尾位置相同。 如果清除此选项,下一行的插入符号将放置在该行的末尾。

    选择 允许在制表符内放置插入符 选项,以帮助您在文件内向上或向下移动插入符号,同时保持其在相同位置。

配置保存时对行尾空格的处理方式

  • 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规。 在 其他 部分,配置行尾空格选项。

    例如,当您保存代码(手动或自动)且希望无论在 保存时删除尾随空格 列表中选择了什么选项,都保留插入符号所在行的行尾空格时,请选择 始终保留插入符所在行的尾随空格 选项。

配置编辑器外观选项

  • 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规 | 外观。

    例如,您可以配置 IDE 显示硬换行参考线或参数提示。

管理长行的显示方式

  1. 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规。

  2. 在 软换行​ 部分,指定适当的选项。

    例如,您可以指定要应用软换行的 文件类型。 当您在 markdown 文件中编写文档时,这可能会有所帮助。

配置智能键

您可以配置基本编辑器操作的行为,使其根据您使用的语言而有所不同。

  • 在 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规 | 智能键。

    例如,对于 Java、SQL 或 Python,您可以选择 使用 Tab 跳出闭合括号/引号 选项,以便在输入代码时使用 Tab 在闭合括号或引号之外导航。

2026年 7月 14日