# 自定义视图

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

在调试会话期间，IntelliJ IDEA 向您显示有关变量、类型、线程、帧等的信息。 然而，您可能希望专注于特定的运行时细节，并以特定格式过滤或呈现数据。 在这种情况下，IntelliJ IDEA 允许您自定义调试器输出在   调试  工具窗口和编辑器中的显示方式。

## 自定义线程视图

您可以自定义线程在   帧   和   线程   选项卡上的显示方式。 当您经常在应用程序的线程中导航，并对其特定细节（例如线程所属的组）感兴趣时，这可能会很有帮助。

Procedure:

* 请右键点击   帧   或   线程   选项卡中的任意位置，然后选择   自定义线程视图  。

![自定义Threads View菜单项](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_customize_threads.png)

|  条目  |  描述  |
| --- | --- |
|  显示线程组  |     如果选择此选项，线程会在线程组的层次结构中显示。 拥有树状层次结构在您的程序管理一组相似线程时很有用。 此外，该选项将系统线程与用户定义的线程分开，更便于在列表中导航。       为了使线程出现在特定组中，请在您的程序中使用  `java.lang.ThreadGroup` 。     |
|  为合成方法显示堆栈帧  |  指定是否希望查看合成方法的堆栈帧（编译器引入的方法，这些方法在源代码中不存在）。 这样的方法示例是由内部类创建的方法，从而封闭类可以访问其私有成员。  |
|  将当前线程移至顶部  |  保持当前线程在列表顶部（当   显示线程组   被禁用时）。  |
|  显示行号  |  显示当前执行的行号。 该功能要求应用程序在编译时包含行号信息。  |
|  显示类名  |     显示包含该方法的类的名称。 在执行匿名内部类中的代码时，会显示外部类的名称，后跟一个美元符号和一个数字，例如：  `MyClass$1` 。       启用此选项在处理继承方法时非常有用，当需要快速区分子类中的方法实现时。     |
|  显示软件包名称  |  显示类的包名称。 默认包中的代码未被标记。 仅当   显示类名   启用时，此选项才会激活。 在类名本身无法消除歧义时使用（例如  `java.util.Date`  与  `java.sql.Date` ）。  |
|  显示源文件名  |  显示类对应的源文件名称。  |
|  显示方法参数类型  |  显示方法接收的参数类型。 这在处理同一方法的重载版本时很有用。  |

## 自定义数据视图

IntelliJ IDEA 允许您配置您想要获取的变量信息。 例如，您可以选择显示/隐藏实例 ID 或使用  `toString`  表示查看特定的类集合。

除非另有明确说明，否则这些偏好设置适用于所有显示变量值的地方（   变量   选项卡、内联值视图、工具提示等）。

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. 请选择   按字母顺序排序变量名。  选项。

Procedure: 配置自动表达式评估

调试器分析断点处的语句及其最近的周围语句，以在源代码中找到各种表达式，如  `myvar.myfield` 。

如果它们不包含显式的方法调用，调试器会对它们进行求值并在   变量   视图中显示相应的值。

> **Note:**
> 在类似 Groovy 的语言中，无法判断在求值表达式时是否调用了任何方法，并且这种方法调用通常会导致不必要的副作用，因此建议在调试 Groovy 代码时禁用此选项。

要禁用表达式的自动计算：

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. 清除   在变量视图中启用自动表达式   选项。

Procedure: 显示/隐藏对象类型

您可以选择是否显示对应引用类型变量的对象类型。

* 右键点击   变量   选项卡中的任意位置，然后打开或关闭   显示类型  。

显示的类型是实际对象的类型，而不是保存引用的变量的类型。 如果您想切换声明类型的可见性，请在 [Customize Data Views](#data-view-properties)对话框中使用 [Declared type](#data-view-properties)选项。

### 配置特定类型的显示

您可以微调特定类型的显示方式。 此处描述的属性适用于最常见的情况。 如需自定义配置，请参阅 [type renderers](#renderers)。

Procedure:

* 在   变量   选项卡的任意位置点击鼠标右键，然后选择   自定义数据视图  。

|  条目  |  描述  |
| --- | --- |
|  自动滚动到新的局部变量  |     在单步执行时自动滚动到作用域中出现的新变量。     |
|  基于数据流分析预测条件值和异常。  |     启用编辑器提示，用于基于数据流分析信息预先已知的布尔表达式或异常。 如需更多信息，请参阅 [内联变量视图](examining-suspended-program.html#inline-view)。     |
|  显示  |      * 声明类型 ：显示保存对象引用的变量类型。    * 合成字段 ：显示合成字段（例如，内部类的编译器生成字段）。    * $val 字段作为局部变量 ：显示在匿名类中使用的外部变量，就像它们是局部变量一样。 需要 合成字段 。    * 完全限定名称 ：显示实际类型和声明类型的全限定名称。    * 对象 id ：提供特定实例的 ID，例如， `java.util.ArrayList@798` 。 要显示 ID，需要启用 [Show Types](#show-object-types) 选项。    * static 字段 ：在 变量 选项卡和工具提示中显示静态字段。    * 静态最终字段 ：显示 变量 选项卡和工具提示中的 static final 常量。 需要 static 字段 。    |
|  显示字符串的类型  |  显示  `java.lang.String`  实例的类型。 禁用时，可以通过双引号来标识此类型。  |
|  为基元显示十六进制值  |  添加了十六进制格式支持  `byte` 、  `short` 、  `int` 、  `long`  和  `char`  类型。 启用后，将显示十进制和十六进制格式。  |
|  在数组和集合中隐藏 null 元素  |  排除  `null`  引用，在显示实现  `集合`  的数组和类的内容时（不适用于  `映射`  的子类）。  |
|  自动填充 Throwable 对象的堆栈跟踪  |  当程序因抛出异常或错误而被挂起时，其栈跟踪中尚无任何元素。 为了填充堆栈跟踪，您必须在此  `getStackTrace()`  上调用  `Throwable` 。 当   自动填充 Throwable 对象的堆栈跟踪   启用时，IntelliJ IDEA 会为您执行此操作。  |
|  为 Collection 类启用替代视图  |  选择此选项以更方便的格式显示实现  `集合` 或  `映射` 的类的内容（例如，将每个映射条目显示为键值对）。  |
|  启用 toString() 对象视图  |     允许您配置哪些类使用  `toString()`  的结果作为其显示值。 当通过完全限定的类名指定时，此选项也适用于这些类的派生类。 您还可以使用正则表达式语法定义一个类模式，例如：        * `*.Test` ：所有称为 `测试` 的类，不管哪个包    * `javax.swing.*` ： `javax.swing` 包中的所有代码及其所有子包    * `?est.Tes?` ：所有以 `Tes` 开头的类，后跟包中以任何字母开头的任何字母，后跟 `est`    * `*.T*` ：所有包中以 `T` 开头的所有类    |

## 自定义类型渲染器

IntelliJ IDEA 允许您为各种类型提供自定义显示格式。 这可以通过使用 renderers 实现。  渲染器  是一种与特定类型相关联的特殊表达式，用于控制在调试会话期间如何显示该类型的实例。

![在 Variables 选项卡中显示为其字段之一的用户定义对象](https://resources.jetbrains.com.cn/help/img/idea/2026.3/debug_renderers.png)

渲染器支持包括基本类型和数组在内的所有类型。 此外，渲染器忽略所有访问修饰符，因此即使字段已被封装，您也可以访问任何字段。

在渲染器中，您可以实现任何转换，包括排序和缩减，以生成所需的输出。 您甚至可以利用  `sun.misc.Unsafe`  在调试过程中显示实际的内存地址（尽管不推荐这样做）。

渲染器在处理自定义集合时尤其有用，因为它们的内容不易读取，您需要一目了然地识别其内容。

> **Note:**
> 请注意以下几点：
>
>
>
> * 在渲染器中使用复杂表达式可能会降低调试性能
>
> * 方法调用应谨慎使用，因为它们可能会产生副作用

Procedure: 添加渲染器

1. 在   变量   选项卡的任意位置点击鼠标右键，然后选择   自定义数据视图  。

2. 在   Java 类型渲染器  选项卡上，点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.add.svg) `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))并配置渲染器表达式。

例如，如果您想根据其  `名称` 字段查看一个对象，请使用  `this.name` 作为表达式。 如需更高级的配置，请参阅 [渲染器属性](#renderer_properties) 章节。

3. 应用更改并在   变量  选项卡中查看更新的显示。

> **Tip:**
> 如果多个渲染器适用于相同类型（例如，当一个类继承另一个类并实现某些接口时，而这两者都有渲染器），则可以通过根据其优先级排序渲染器列表来解决冲突。

### 渲染器属性

|  条目  |  描述  |
| --- | --- |
|  渲染器名称  |  渲染器的名称。 此名称用于管理渲染器，不影响实际数据的显示。  |
|  将渲染器应用于类型为（完全限定名称）的对象  |     此渲染器适用的对象类型。 请输入类的完全限定名或点击   浏览   ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.ellipsis.svg)，并从列表中选择所需类型。       如果类使用泛型，请使用原始类型。 由于类型擦除，泛型类型在渲染器中无效。     |
|  渲染节点时  |     此选项决定对象本身的显示方式：        * 显示类型和对象 ID ：控制类名称和实例 ID 是否显示。    * 使用默认渲染器 ：按照没有此渲染器时的方式显示对象。 如果您只想自定义对象内容的显示方式，请使用此选项。    * 使用以下表达式 ：允许您使用某些表达式的返回值来显示对象。 所有方法调用和成员变量访问都是相对于呈现的实例。 例如， `this.getName()` 将使用 `getName()` getter 的结果来显示对象。 按需 选项会禁用表达式的自动计算，并且只有在您明确请求时才会计算结果。    |
|  展开节点时  |     此选项决定对象展开时内容的显示方式。        * 使用默认渲染器 ：显示节点子节点的方式与未使用此渲染器时相同。 如果您只想自定义对象本身的显示方式，这会很有用。    * 使用以下表达式 ：允许您使用一些表达式的返回值来显示节点的内容，例如， `this.toArray()` 。 表达式必须返回原始类型或引用类型的数组。 返回数组的元素用于表示节点的子项。 测试节点是否可以展开（可选） ：添加一个自动检查，验证表示对象的节点是否可以展开。 检查使用指定的布尔表达式，例如 `!this.isEmpty()` 。 表达式在实例上调用，如果计算结果为 `true` ，调试器将使节点可扩展。    * 使用表达式列表 ：允许您指定多个表达式，每个表达式提供节点子项的不同表示。 按需 选项会禁用它们的自动计算，仅在您选择特定表达式时进行结果计算。    |
|  追加默认子节点  |  控制对象的字段（在未指定渲染器时通常显示）是否应与表达式结果一起显示。 此选项仅在   使用表达式列表   中可用。  |

Procedure: 移除渲染器

1. 在   变量   选项卡的任意位置点击鼠标右键，然后选择   自定义数据视图  。

2. 在   Java 类型渲染器  选项卡上，选择您将要移除的渲染器，然后点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.remove.svg) `Delete` (Windows), `⌦` (macOS), `⌦` (IntelliJ IDEA Classic (macOS)), `⌦` (macOS System Shortcuts), `Delete` (XWin), `Delete` (GNOME), `Delete` (KDE), `Delete` (Emacs), `Delete` (Sublime Text), `⌦` (Sublime Text (macOS)), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (NetBeans), `Delete` (Eclipse), `⌦` (Eclipse (macOS))。 然后，应用更改。

Procedure: 禁用渲染器

您可以暂时禁用渲染器，而不必完全删除它们：

* 要静音单个 renderer，请右键点击   变量   选项卡中的任意位置，然后选择   自定义数据视图  。 在   Java 类型渲染器  选项卡上，取消选中您要静音的renderer旁边的框，并应用更改。

* 要静音所有渲染器，请右键点击   变量   选项卡中的任意位置，然后选择   忽略呈现器  。

当需要时，您可以使用相同的步骤取消静音 renderers。

Procedure: 使用注解添加渲染器

您可以使用 IntelliJ IDEA 的 [内置注释](annotating-source-code.html)将类型渲染器分配给您的类。 当您需要与团队成员共享渲染器时，注解非常有用。 一旦配置，渲染器将在每次调试使用该类（及其子类）的代码时应用。

* 在类声明前一行，添加  `@Renderer` 注释，例如：

```JAVA
import org.jetbrains.annotations.Debug.Renderer;

@Renderer(text = "name",
	childrenArray = "courses.toArray()",
	hasChildren = "courses.!isEmpty()")
public class Student {
	private String name;
	private List<String> courses;
	Student(String name, List<String> courses){
		this.name=name;
		this.courses=courses;
	}
}

```

|  text()  |  指定用于显示渲染对象的表达式。  |
|  childrenArray()  |  指定用于显示渲染对象子元素的表达式。 表达式的返回值必须是一个数组。  |
|  hasChildren()  |  指定检查节点是否应可展开的表达式。  |

## 效率提示

在大型项目中使用渲染器
: 如果您正在处理一个大型项目，并且花费大量时间处理自定义类，那么创建自己的渲染器虽然需要一些时间，但会有所回报。

在渲染器中实现排序
: 用于显示节点子级的表达式返回一个数组。 由于数组是有序的，您可以对原本无序的结构进行排序，例如  `HashMap` 。 例如，当您拥有一个用户地图并希望按电子邮件地址排序查看时，这很有用。

