# 编辑器装订区域

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

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

![编辑器装订区域](https://resources.jetbrains.com/help/img/idea/2026.3/ij_gutter.png)

如果您使用较小的屏幕，并希望装订线和其他 UI 元素占用更少的空间，您可以启用 [紧凑模式](new-ui.html#compact-mode)。

如果您使用屏幕阅读器，您可以将其 [配置](accessibility.html#gutter_icons)为读取行号、注释和图标工具提示。

Procedure: 配置边距外观

* 要配置装订区域外观，请右键点击装订区域并导航到   外观  。

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

* 行号

* 行号上的断点

* 缩进参考线

* 粘性行

* 路径导航

![配置边距外观](https://resources.jetbrains.com/help/img/idea/2026.3/configure_gutter_appearance.png)

## 行号

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

Procedure: 配置行号

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

1. 打开   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），然后转到  `编辑器 | 常规 | 外观` 。

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

绝对:

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

![绝对行号](https://resources.jetbrains.com/help/img/idea/2026.3/ij_line_numbering_absolute.png)

相对:

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

![相对行号](https://resources.jetbrains.com/help/img/idea/2026.3/ij_line_numbering_relative.png)

混合:

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

![混合行号](https://resources.jetbrains.com/help/img/idea/2026.3/ij_line_numbering_hybrid.png)

Procedure: 隐藏行号

要隐藏行号，请执行以下操作之一：

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

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

## 代码折叠

为了根据手头的任务调整代码视图，您可以使用 [代码折叠](working-with-source-code.html#code_folding)。 默认情况下，展开区域的图标会在悬停时显示。

![代码折叠](https://resources.jetbrains.com/help/img/idea/2026.3/new_ui_code_folding.animated.gif)

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

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

## 操作图标

可用的 [标记图标列表](null)取决于您的项目配置、您使用的框架以及您已安装的插件。 例如，可以使用操作图标 [跟踪类的实现和重写方法](navigating-through-the-source-code.html#go_to_implementation)，或者 [运行](run-java-applications.html#run_application)应用程序。

要访问适用于项目的装订区域图标列表，请转到  `设置 | 编辑器 | 常规 | 标记栏图标` 。

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

![“设置”对话框中的装订区域图标设置](https://resources.jetbrains.com/help/img/idea/2026.3/gutter_icons_settings.png)

## 书签

代码行 [书签](bookmarks.html)用于标记特定的代码行，以便稍后快速导航到它们。

Procedure: 添加匿名行书签

* 在编辑器中，将文本光标置于某一代码行，然后按 `F11` (Windows), `F3` (macOS), `F11` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ K` (macOS System Shortcuts), `F11` (XWin), `F11` (GNOME), `F11` (KDE), `F11` (Emacs), `Ctrl+F2` (Sublime Text), `⌘ F2` (Sublime Text (macOS)), `Ctrl+K, K` (Visual Studio), `⌘ K, K` (Visual Studio (macOS)), `F11` (NetBeans), `Ctrl+Shift+F11` (Eclipse), `F11` (Eclipse (macOS))。

* 或者，右键点击要添加书签的代码行旁边的装订区域，然后选择   添加书签  。

![放置在装订区域中的匿名书签](https://resources.jetbrains.com/help/img/idea/2026.3/ij-anonymous-bookmark.png)

书签图标会出现在已添加书签的行旁的装订区域中。

Procedure: 添加记忆行书签

1. 在编辑器中，将文本光标置于某一代码行，然后按 `Ctrl+F11` (Windows), `⌥ F3` (macOS), `⌘ F11` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ⇧ K` (macOS System Shortcuts), `Ctrl+F11` (XWin), `Ctrl+F11` (GNOME), `Ctrl+F11` (KDE), `Ctrl+F11` (Emacs), `Ctrl+F11` (Sublime Text), `⌥ F3` (Sublime Text (macOS)), `Ctrl+F11` (Visual Studio), `⌥ F3` (Visual Studio (macOS)), `Ctrl+F11` (NetBeans), `Ctrl+Alt+Shift+F11` (Eclipse), `⌥ F3` (Eclipse (macOS))。

或者，右键点击要添加书签的代码行旁边的装订区域，然后选择   添加速记书签  。

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

![添加助记书签](https://resources.jetbrains.com/help/img/idea/2026.3/ij-add-mnemonic.png)

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

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

4. 按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))，或再次点击所选字母或数字以保存书签。

带字母或数字的书签图标会出现在已添加书签的行旁的装订区域中。

## 调试器

编辑区域界面作为 [调试](debugging-code.html)应用程序的便捷入口。

Procedure: 启动调试器会话

* 要 [启动调试器会话](starting-the-debugger-session.html)，点击靠近带有  `main()` 方法的类旁的标签中的   运行   ![运行图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg)图标并选择   调试  。 这将创建一个临时运行/调试配置。

![运行/调试选项](https://resources.jetbrains.com/help/img/idea/2026.3/ij_debug_gutter.png)

装订区域栏还允许您 [管理断点](using-breakpoints.html)。

Procedure: 管理断点

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

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

* 要在调用某个类的默认构造函数时暂停程序，请点击类声明行的标记栏。

* 要设置字段观察点，请点击字段声明行的标记栏。

* 要移除非异常断点，请点击边栏中的断点。

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

Procedure: 配置断点图标

默认情况下， [断点图标](using-breakpoints.html#breakpoint-icons)会放置在行号上方以节省水平空间。

![断点](https://resources.jetbrains.com/help/img/idea/2026.3/new_ui_breakpoints.png)

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

## 代码覆盖率

[代码覆盖率](code-coverage.html) 允许您测量测试覆盖的代码量。

编辑器会显示各代码行的覆盖率状态 状态通过装订区域的彩色标记表示：

* 绿色（ ![绿色高亮显示，表示完全覆盖](https://resources.jetbrains.com/help/img/idea/2026.3/go_full_code_coverage.png)）：该代码行已被执行

* 黄色（ ![黄色高亮显示，表示部分覆盖](https://resources.jetbrains.com/help/img/idea/2026.3/go_partial_code_coverage.png)）：该代码行被部分执行 当代码行包含条件逻辑（如 `if/else` 语句、循环或 `switch` 语句）时会出现这种情况，但只有部分分支被运行

* 红色（ ![红色高亮显示，表示未覆盖](https://resources.jetbrains.com/help/img/idea/2026.3/go_uncovered_code_coverage.png)）：该代码行未被执行

如需打开某行的覆盖率统计弹窗，请点击其在装订区域的覆盖率标记。 根据你使用的覆盖率运行器不同，弹窗会显示不同内容：

JaCoCo 运行器:

![用于 switch 语句、由 IntelliJ IDEA 运行器运行的代码覆盖率弹窗](https://resources.jetbrains.com/help/img/idea/2026.3/coverage-editor-popup-jacoco-runner.png)

对于 JaCoCo 运行器，弹窗可以显示以下信息：

* 完全覆盖 ：代码行已被执行 如果包含条件逻辑，所有可能的分支都会被运行

* 部分覆盖 ：代码行已被执行，但只有部分条件逻辑分支被运行

* 未涵盖 ：该代码行完全未被执行

* 已覆盖 <number>/<number> 分支 ：条件逻辑中已运行分支数与分支总数的比值

IntelliJ IDEA 运行器:

![用于 switch 语句、由 IntelliJ IDEA 运行器运行的代码覆盖率弹窗](https://resources.jetbrains.com/help/img/idea/2026.3/coverage-editor-popup-intellij-runner.png)

对于 IntelliJ IDEA 运行器，弹窗可以显示以下信息：

* 命中次数 ：代码行被执行的次数

* 如果该行包含条件逻辑（如 `if/else` 语句、三元运算符或循环）： * 真实命中 ：条件为真的次数。 * 伪命中 ：条件为假的次数。

* 如果代码行包含 `switch` 语句： * case <值> ：某个具体 case 被执行的次数。

此外，弹窗中还包含以下图标：

![向上箭头](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.ide.expui.general.up.svg)
: 上一个 <覆盖状态>
:
: 跳转到上一个覆盖率标记并打开其统计信息。

![向下箭头](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.ide.expui.general.down.svg)
: 下一个 <覆盖状态>
:
: 跳转到下一个覆盖率标记并打开其统计信息。

![带有 JUnit 图标的文件夹图标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.ide.expui.nodes.testSourceFolder.svg)
: 显示覆盖该行的测试
:
: 在单独的弹窗中显示覆盖当前代码行的测试
:
:
:
: > **Note:**
: > 此选项仅在满足以下条件时可用：
: >
: >
: >
: > * 覆盖率分析通过 [JUnit](run-debug-configuration-junit.html) 或 [TestNG](run-debug-configuration-testng.html) 运行配置运行
: >
: > * 分析运行时， [覆盖率设置](code-coverage.html#project_settings)按如下方式设置 * 选择覆盖率运行程序 被设置为 %instance% 。 * 已选择 按测试覆盖率跟踪 。
: >
: > * 该代码行在分析中已被完全或部分覆盖。

![字节码图标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.ide.expui.fileTypes.javaClass.svg)
: 显示字节码
:
: 在单独的工具窗口中显示当前类的字节码。

![设置图标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.ide.expui.general.settings.svg)
: 编辑覆盖颜色
:
: 打开  `设置 | 编辑器 | 配色方案 | 常规`  以 [自定义覆盖率标记的颜色](configuring-colors-and-fonts.html#edit-colors)。

![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.empty.png)
: 隐藏覆盖率
:
: 停止在 IntelliJ IDEA 中显示覆盖率结果。

## 版本控制

> **Note:**
> 如果您为您的 project 启用了 [VCS 集成](version-control-integration.html)，则可以使用这些功能。

Procedure: 配置 Git Blame 注释

您可以使用 [VCS 注解](investigate-changes.html#annotate_blame)找出是谁对文件做了哪些更改。

要启用注解，请右键点击装订区域并选择   使用 Git Blame 添加注释  。

![Git Blame 注解](https://resources.jetbrains.com/help/img/idea/2026.3/new_ui_git_annotations.png)

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

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

* 颜色 。 右键点击注解并转到  `视图 | 颜色` 。 可以选择要高亮显示的内容：更改的顺序，以便更轻松地查看最近的提交；或更改的作者。 要禁用高亮，请选择   隐藏   选项。

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

您还可以在编辑器中修改文件时跟踪更改。 所有更改都会通过  更改标记 高亮显示，这些标记显示在已修改行旁边的装订区域中，并显示自上次 [与仓库同步](sync-with-a-remote-repository.html)以来引入的更改类型。 将更改提交到仓库后，更改标记会消失。

您对文本所做的更改是用颜色编码的：

![添加、修改和删除行的高亮颜色](https://resources.jetbrains.com/help/img/idea/2026.3/change_markers_colors.png)

下表列出了在某些 [color schemes](configuring-colors-and-fonts.html)中默认的行高亮颜色及其含义。

浅色主题:

|  颜色  |  行状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：浅蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-lines-light.png) #C3D6E8  |  已修改的行  |  自上次更新以来已修改的行。  |
|  ![颜色样本：浅橙色](https://resources.jetbrains.com/help/img/idea/2026.3/whitespace-modified-lines-light.png) #EDDCBC  |  空格修改的行  |  自上次更新以来仅修改了空格的行。  |
|  ![颜色样本：浅绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-lines-light.png) #C9DEC1  |  已添加行  |  自上次更新以来添加的行。  |
|  ![灰色三角形](https://resources.jetbrains.com/help/img/idea/2026.3/gutterGray.png) #9F9F9F  |  已删除的行  |  自上次更新以来已移除的行。  |

Darcula 主题:

|  颜色  |  行状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：深灰蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-lines-darcula.png) #374752  |  已修改的行  |  自上次更新以来已修改的行。  |
|  ![颜色样本：深灰橙色](https://resources.jetbrains.com/help/img/idea/2026.3/whitespace-modified-lines-darcula.png) #4C4638  |  空格修改的行  |  自上次更新以来仅修改了空格的行。  |
|  ![颜色样本：深灰绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-lines-darcula.png) #384C38  |  已添加行  |  自上次更新以来添加的行。  |
|  ![灰色三角形](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-line-darcula.png) #656E76  |  已删除的行  |  自上次更新以来已移除的行。  |

高对比度主题:

|  颜色  |  行状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-lines-hcontrast.png) #1AABFF  |  已修改的行  |  自上次更新以来已修改的行。  |
|  ![颜色示例：灰色](https://resources.jetbrains.com/help/img/idea/2026.3/whitespace-modified-lines-hcontrast.png) #666666  |  空格修改的行  |  自上次更新以来仅修改了空格的行。  |
|  ![颜色样本：绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-lines-hcontrast.png) #009924  |  已添加行  |  自上次更新以来添加的行。  |
|  ![橙色三角形](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-line-hcontrast.png) #FFA14F  |  已删除的行  |  自上次更新以来已移除的行。  |

> **Tip:**
> 您可以在   编辑器 | 配色方案 | VCS   设置页面 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 上自定义行状态的默认颜色。
>
>
>
> 要禁用装订区域中的 VCS 标记，请在   版本控制 | 确认   设置页面 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 上取消选中   在装订区域高亮显示修改的行   选项。

将鼠标悬停在更改标记上并点击它时，会出现一个工具栏，可使用该工具栏管理更改。 工具栏与显示被修改行先前内容的框架一起显示：

![修改行标记](https://resources.jetbrains.com/help/img/idea/2026.3/changeMarkerToolbar.png)

点击 !["还原"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.revert.svg) 可回滚更改，点击 ![显示差异图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.diff.svg) 可查看当前行与仓库版本之间的差异。

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

