PyCharm 2025.3 Help

编辑器装订区域

装订区域是编辑器左侧的一个垂直区域。 在编写代码时,装订区域会提供触手可及的重要信息和操作图标。 您可以根据个人偏好自定义装订区域的外观与行为。

编辑器装订区域

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

如果您使用屏幕阅读器,您可以对其进行 配置 ,以朗读装订区域中的行号、注解和图标工具提示。

配置装订区域外观

  • 要配置装订区域外观,请右键点击装订区域并转到 外观

    您可以配置以下装订区域元素:

    • 行号

    • 行号上的断点

    • 缩进指示线

    • 粘性行

    • 面包屑

    配置装订区域外观

行号

默认情况下,装订区域显示行号,这有助于在与团队成员讨论或浏览代码时引用特定代码行。

配置行号

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

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

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

    标准行编号,从文件顶部到文件底部按顺序编号,为每一行分配唯一的编号。 此模式有助于直接导航,并在讨论或错误消息中引用特定行。

    绝对行号

    行号显示每一行与插入符当前位置相距多少行。 这对于使用 键盘快捷键 快速移动或编辑代码块特别有用。

    相对行号

    此模式结合绝对与相对行编号,在插入符当前位置显示绝对行号,在其他所有行显示相对行号。 它能同时利用两种方式的优点,实现高效的导航与编辑。

    混合行号

隐藏行号

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

  • 右键点击装订区域并取消选择 外观 | 显示行号

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

代码折叠

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

代码折叠

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

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

操作图标

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

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

要在装订区域中显示或隐藏某个图标,请选中或清除其旁边的复选框。 如需禁用所有装订区域图标,请清除列表顶部的 显示装订区域图标(I) 复选框。

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

书签

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

添加匿名行书签

  • 在编辑器中,将插入符置于某行代码处,然后按下 F11

  • 或者,右键点击该代码行旁边的装订区域,然后选择 添加书签

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

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

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

添加带助记符的行书签

  1. 在编辑器中,将插入符置于某行代码处,然后按下 Ctrl+F11

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

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

    添加带助记符的书签:选择标识符

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

  3. 您还可以为新书签提供描述。

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

    在书签所在行旁的装订区域会出现字母或数字书签图标。

调试器

编辑器装订区域是 调试应用程序的便捷入口。

启动调试会话

  • 启动调试会话 ,在包含 main() 方法的类旁的装订区域中点击 运行 运行图标 图标,然后选择 调试。 这将为您创建一个临时的运行/调试配置。

    运行/调试选项

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

管理断点

  • 要设置行断点,请在可执行的代码行处点击装订区域。

  • 要设置方法断点,请在声明该方法的行处点击装订区域。

  • 要移动断点,请将其拖动到装订区域中的另一行。

配置断点图标

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

断点

要将断点放置在靠近行号的位置,请右键点击装订区域并取消选择 外观 | 在行号上显示断点

    版本控制

    配置 Git Blame 注解

    您可以使用 VCS 注解来确定是谁向文件引入了哪些更改。

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

    Git Blame 注解

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

    • 注解内容。 右键点击某个注解,然后转到 视图。 您可以选择要在注解中包含的信息:修订号、更改日期、作者姓名。

    • 颜色。 右键点击某个注解,然后转到 视图 | 颜色。 您可以选择要高亮的内容:更改的顺序(便于查看最近的提交),或更改的作者。 要禁用高亮,请选择 隐藏 选项。

    • 名称。 右键点击某个注解,然后转到 视图 | 名称。 您可以选择作者标签的显示方式:使用其全名、仅名字或仅姓氏、首字母缩写或电子邮件。

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

    您对文本引入的更改会以颜色进行区分:

    新增、修改和删除行的高亮颜色

    下表列出了某些 配色方案中的默认行高亮颜色及其含义。

    颜色

    行状态

    描述

    颜色示例:浅蓝色 #C3D6E8

    已修改的行

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

    颜色示例:浅橙色 #EDDCBC

    仅空白被修改的行

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

    颜色示例:浅绿色 #C9DEC1

    已添加的行

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

    灰色三角形 #9F9F9F

    已删除的行

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

    颜色

    行状态

    描述

    颜色示例:深灰蓝色 #374752

    已修改的行

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

    颜色示例:深灰橙色 #4C4638

    仅空白被修改的行

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

    颜色示例:深灰绿色 #384C38

    已添加的行

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

    灰色三角形 #656E76

    已删除的行

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

    颜色

    行状态

    描述

    颜色示例:蓝色 #1AABFF

    已修改的行

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

    颜色示例:灰色 #666666

    仅空白被修改的行

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

    颜色示例:绿色 #009924

    已添加的行

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

    橙色三角形 #FFA14F

    已删除的行

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

    您可以使用当鼠标悬停在更改标记上并点击后出现的工具栏来管理更改。 该工具栏会与一个显示已修改行先前内容的框架一并显示:

    更改工具栏

    您可以点击 还原图标 回滚更改,并点击 显示差异图标 查看当前行与存储库版本之间的差异。

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

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