代码折叠

在这个页面中：

• 基础
• 代码折叠方法
• 折叠预定义和自定义区域
• 折叠菜单的命令和关联的快捷键
• 指定代码折叠偏好
• 查看折叠的代码片段
  • 查看折叠区域的开始
• 使用代码折叠注释
  • 支持折叠注释
  • 用折叠注释环绕片段
  • 跳转到折叠区域

基础

你可以折叠代码片段将它们减少到一个可见行。用这种方法，你可以隐藏细节，在这时候，它看起来不怎么重要了。如果有必要，折叠的代码可以展开。

折叠的代码片段，通常，展示为暗色的省略号()

代码折叠方法

你可以折叠和展开代码通过使用：

• 代码折叠开关(，或)。这些开关显示在编辑器左边相应的折叠区域。如果该区域是展开的，表示折叠区域的开始，表示折叠区域的结尾。对于已经折叠的区域，开关显示为。

  如果你按住ALT同时点击(，或，该区域将递归的展开或折叠，例如，连同其所有下属区域。

• 折叠菜单的命令与快捷键关联。可以通过主菜单的（Code | Folding）或编辑器的上下文菜单访问折叠菜单。快捷键显示在菜单的右侧。 参见折叠菜单的命令和关联的快捷键。

• 折叠的代码片段：点击来展开相应的部分。另请参阅查看折叠的代码片段。

折叠预定义和自定义区域

你可以折叠和展开：

• 预定义区域环绕着元素比如导入声明，方法体，注释文档等等。预定义的区域，大致的，对应设置参数对话框的Editor | General | Code Folding页面的Collapse by default的列表。

  对于预定义区域，折叠开关是可用的，不需要执行额外的动作。

• 一个选定的片段。一个定制选中区的折叠区域通过 Fold Selection/ Remove Region命令(Ctrl+.)创建和移除。

• 用相应折叠注释标记环绕的区域（例如，//<editor-fold desc="Description">...//</editor-fold>）。参见使用代码折叠注释

折叠菜单的命令和关联的快捷键

可以通过主菜单的（Code | Folding）或编辑器的上下文菜单访问折叠菜单

指定代码折叠偏好

你可以指定：

• 是否显示代码折叠开关
• 哪种折叠区域应默认折叠

相应的设置在设置对话框(Ctrl+Alt+S)的Editor | General | Code Folding页面。

更多信息参考代码折叠页面

查看折叠的代码片段

要查看折叠部分的代码内容，鼠标指向省略号来显示这部分内容。

查看折叠区域的开始

要查看折叠区域的开始-如果当前看不到-指向目标区域的尾部折叠开关。

使用代码折叠注释

• 支持折叠注释
• 用折叠注释环绕片段
• 跳转到折叠区域

支持折叠注释

你可以创建自定义折叠区域通过对代码片段环绕注释行。这样做，注释可以是NetBeans风格或Visual Studio风格。

NetBeans风格

//<editor-fold desc="Description">
...
//</editor-fold>

Visual Studio风格

//region Description
...
//endregion

一旦当你已经在一个文件中选用一个风格，不要在该文件中使用其它风格的注释。

用折叠注释环绕片段

1. 选择感兴趣的代码片段
2. 选择Code | Surround With或按Ctrl+Alt+T

3. 选择要使用的折叠注释

   

4. 指定片段描述

   

   现在如果你折叠了这个片段，你指定的描述将展现在代码的地方。

   

跳转到折叠区域

你可以跳转到被折叠注释标志包围而形成的折叠区域：

1. 选择Navigate | Custom Folding或按Ctrl+Alt+.

2. 选择目标折叠区域。(列表中的区域是根据它们的描述形成)

   

另请参阅：

规程：

• 代码折叠参考

入门指南：

• PhpStorm编辑器