PyCharm 2025.3 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 )中,转到 编辑器 | 常规 | 外观 ,并清除 悬停在滚动条上时显示代码透镜 复选框。

编辑器选项卡

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

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

打开或关闭选项卡

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

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

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

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

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

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

复制路径或文件名

  1. 右键点击该选项卡。

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

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

    复制路径

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

移动、移除或排序选项卡

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

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

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

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

固定或取消固定选项卡

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

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

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

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

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

分离选项卡

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

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

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

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

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

在选项卡之间切换

  • 要在选项卡之间切换,请按 Alt+RightAlt+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. 在选项列表中,选择以下选项之一:

    • 将编辑器拉伸到顶部

    • 将编辑器拉伸到左侧

    • 将编辑器拉伸到底部

    • 将编辑器拉伸到右侧

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

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

快速弹出窗口

说明

操作/访问

提示

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

Ctrl+Shift+I

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

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

Ctrl+Q

在弹出窗口中显示文档。

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

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

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

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

查看 上下文信息

Alt+Q

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

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

Ctrl+F1

点击代码分析标记以查看检测到的错误列表。 使用 F2Shift+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 在闭合括号或引号之外导航。

最后修改日期: 2025年 12月 2日