PyCharm 2025.2 Help

编辑器装订区域

编辑器左侧的竖直区域称为注释区。 边栏在您编写代码时提供了重要的信息和易于访问的操作图标。 可以根据您的偏好自定义边栏的外观与行为。

编辑器装订区域

如果您使用较小的屏幕,并希望装订线和其他 UI 元素占用更少的空间,您可以启用 紧凑模式

如果您使用屏幕阅读器,您可以将其 配置为读取行号、注释和图标工具提示。

配置边距外观

  • 要配置边距外观,请右键点击边距并导航到 外观

    您可以配置以下边距元素:

    • 行号

    • 行号上的断点

    • 缩进指南

    • 粘性行

    • 面包屑

    配置边距外观

行号

默认情况下,边栏会显示行号,这使得在与团队成员讨论代码或浏览代码时更容易引用特定的行。

配置行号

您可以根据您的需要在多种行号模式之间切换。

  1. 打开 设置 对话框(Ctrl+Alt+S ),然后转到 编辑器|常规|外观

  2. 启用 显示行号 选项后,从下拉菜单中选择所需的行号模式:

    标准行号按顺序从文件顶部到底部运行,给每行一个唯一的编号。 该模式对于直接导航和在讨论或错误消息中引用特定行非常有用。

    绝对行号

    行号显示每行与文本光标当前位置之间的距离。 这对于使用 keyboard shortcuts快速移动或编辑代码块特别有用。

    相对行号

    此模式结合了绝对行号和相对行号,显示文本光标当前位置的绝对行号,并在所有其他行上显示相对行号。 它允许使用两个系统的优点来实现高效的导航和编辑。

    混合行号

隐藏行号

要隐藏行号,请执行以下操作之一:

  • 右键点击边距并取消选择 外观 | 显示行号

  • 设置 对话框中,前往 编辑器|常规|外观 并取消选中 显示行号 选项。

代码折叠

为了根据当前任务调整代码视图,您可以使用 代码折叠。 默认情况下,展开区域的图标会在悬停时显示。

代码折叠

若要始终显示折叠图标,请转到 设置 | 编辑器 | 常规 | 代码折叠 并在 始终 旁边选择 显示代码折叠箭头

要始终隐藏折叠图标,请转到 设置 | 编辑器 | 常规 | 代码折叠 并清除 显示代码折叠箭头 复选框。

操作图标

可用的 标记图标列表取决于您的项目配置、您使用的框架以及您已安装的插件。 例如,操作图标可用于 跟踪类实现和重写方法 ,或 运行应用程序。

要访问项目中可用的列表图标,请转到 设置 | 编辑器 | 常规 | 栏标图标

要在边距中显示或隐藏图标,请选中或取消选中其旁边的复选框。 如果您想禁用所有页边图标,请清除列表顶部的 显示装订区域图标(I) 复选框。

在设置对话框中的装订区域图标设置

书签

代码行 书签用于标记特定的代码行,以便稍后快速导航到它们。

添加匿名行书签

  • 在编辑器中,将文本光标放在一行代码上,然后按 F11

  • 或者,右键点击您要添加书签的代码行旁边的边距,然后选择 添加书签

    在编辑器中放置的匿名书签

书签图标会出现在带有书签的行旁边的装订区域。

在编辑器中放置的匿名书签

添加记忆行书签

  1. 在编辑器中,将文本光标放在一行代码上,然后按 Ctrl+F11

    或者,右键点击您要添加书签的代码行旁边的边距,然后选择 添加助记书签

  2. 在弹出窗口中,选择您想要用作此书签标识符的数字或字母。

    添加助记符书签:选择一个标识符

    如果所选的助记符已被使用,IDE 会询问您是否希望使用新的书签覆盖现有的书签。 请选择 不再询问 选项,以静默方式覆盖助记符。

  3. 如果需要,可以为新书签提供描述。

  4. Enter 或再次点击所选字母或数字以保存书签。

    在带书签的行旁边的外边距中会出现一个带有字母或数字的书签图标。

调试器

编辑区域界面作为 调试应用程序的便捷入口。

启动调试器会话

  • 启动调试器会话 ,点击靠近带有 main() 方法的类旁的标签中的 运行 运行图标 图标并选择 调试。 这将为您创建一个临时运行/调试配置。

    运行/调试选项

装订区域栏还允许您 管理断点

管理断点

  • 若要设置行断点,请点击可执行代码行的边距。

  • 若要设置方法断点,请点击声明方法所在行的边栏。

  • 要移动断点,请拖动它到边距的另一行。

配置断点图标

默认情况下, 断点图标放置在行号上方以节省水平空间。

断点

将断点放置在行号附近,右键点击边距并取消选择 外观 | 断点显示在行号上

    版本控制

    配置 Git Blame 注释

    您可以使用 VCS 注解找出是谁对文件做了哪些更改。

    要启用注解,请右键点击装订区域并选择 使用Git 追溯注解(N)

    Git Blame 注解

    您可以配置注解以根据您的偏好显示信息:

    • 注释内容. 右键点击注解并前往 视图。 您可以选择要包含在注释中的信息:修订编号、变更日期、作者名称。

    • 颜色。 右键点击注解并前往 视图 | 颜色。 您可以选择需要突出显示的内容:更改的顺序使最近的提交更容易看到,或更改的作者。 要禁用高亮,请选择 隐藏 选项。

    • 名称。 右键点击注解并前往 视图 | 名称。 您可以选择如何标记作者:使用他们的全名、仅名字或仅姓氏、首字母缩写或电子邮件。

    您还可以在编辑器中修改文件时跟踪更改。 所有更改都用 更改标记突出显示,这些标记会出现在修改行旁边的装订区域,并显示自您上次 与存储库同步以来引入的更改类型。 当您提交更改到存储库时,更改标记将消失。

    您对文本进行的更改采用颜色编码:

    添加、修改和删除行的高亮颜色

    下表列出了在某些 color schemes中默认的行高亮颜色及其含义。

    颜色

    行状态

    描述

    颜色样本:浅蓝色 #C3D6E8

    已修改的行

    自上次更新以来已修改的行。

    颜色样本:浅橙色 #EDDCBC

    空白修改的行

    自上次更新以来仅修改了空白的行。

    颜色样本:浅绿色 #C9DEC1

    新增的行

    自上次更新以来添加的行。

    灰色三角形 #9F9F9F

    已删除的行

    自上次更新以来被删除的行。

    颜色

    行状态

    描述

    颜色样本:深灰蓝色 #374752

    已修改的行

    自上次更新以来已修改的行。

    颜色样本:深灰橙色 #4C4638

    空白修改的行

    自上次更新以来仅修改了空白的行。

    颜色样本:深灰绿色 #384C38

    新增的行

    自上次更新以来添加的行。

    灰色三角形 #656E76

    已删除的行

    自上次更新以来被删除的行。

    颜色

    行状态

    描述

    颜色样本:蓝色 #1AABFF

    已修改的行

    自上次更新以来已修改的行。

    颜色示例:灰色 #666666

    空白修改的行

    自上次更新以来仅修改了空白的行。

    颜色示例:green #009924

    新增的行

    自上次更新以来添加的行。

    橙色三角形 #FFA14F

    已删除的行

    自上次更新以来被删除的行。

    当您将光标悬停在更改标记上并点击它时,可以使用出现的工具栏来管理更改。 工具栏与显示被修改行先前内容的框架一起显示:

    更改工具栏

    您可以通过点击 还原 图标 撤销更改,并通过点击 显示差异图标 探索当前行与存储库版本之间的差异。

    与其恢复整个文件,您可以复制此弹出窗口中内容的任何部分并将其粘贴到编辑器中。

    最后修改日期: 2025年 9月 26日