# 代码折叠 在这个页面中： * [基础](#基础) * [代码折叠方法](#代码折叠方法) * [折叠预定义和自定义区域](#折叠预定义和自定义区域) * [折叠菜单的命令和关联的快捷键](#折叠菜单的命令和关联的快捷键) * [指定代码折叠偏好](#指定代码折叠偏好) * [查看折叠的代码片段](#查看折叠的代码片段) * [查看折叠区域的开始](#查看折叠区域的开始) * [使用代码折叠注释](#使用代码折叠注释) * [支持折叠注释](#支持折叠注释) * [用折叠注释环绕片段](#用折叠注释环绕片段) * [跳转到折叠区域](#跳转到折叠区域) ## <span id='基础'>基础</span> 你可以折叠代码片段将它们减少到一个可见行。用这种方法，你可以隐藏细节，在这时候，它看起来不怎么重要了。如果有必要，折叠的代码可以展开。 折叠的代码片段，通常，展示为暗色的省略号() ## <span id='代码折叠方法'>代码折叠方法</span> 你可以折叠和展开代码通过使用： * 代码折叠开关(，或)。这些开关显示在编辑器左边相应的折叠区域。如果该区域是展开的，表示折叠区域的开始，表示折叠区域的结尾。对于已经折叠的区域，开关显示为。 如果你按住`ALT`同时点击(，或，该区域将递归的展开或折叠，例如，连同其所有下属区域。 * **折叠**菜单的命令与快捷键关联。可以通过主菜单的（**Code | Folding**）或编辑器的上下文菜单访问折叠菜单。快捷键显示在菜单的右侧。 参见[折叠菜单的命令和关联的快捷键](#折叠菜单的命令和关联的快捷键)。 * 折叠的代码片段：点击来展开相应的部分。另请参阅[查看折叠的代码片段](#查看折叠的代码片段)。 ## <span id='折叠预定义和自定义区域'>折叠预定义和自定义区域</span> 你可以折叠和展开： * **预定义区域**环绕着元素比如导入声明，方法体，注释文档等等。预定义的区域，大致的，对应设置参数对话框的**Editor | General | Code Folding**页面的**Collapse by default**的列表。 对于预定义区域，折叠开关是可用的，不需要执行额外的动作。 * 一个选定的片段。一个定制选中区的折叠区域通过** Fold Selection/ Remove Region**命令(`Ctrl+.`)创建和移除。 * 用相应折叠注释标记环绕的区域（例如，`//<editor-fold desc="Description">...//</editor-fold>`）。参见[使用代码折叠注释](#使用代码折叠注释) ## <span id='折叠菜单的命令和关联的快捷键'>折叠菜单的命令和关联的快捷键</span> 可以通过主菜单的（**Code | Folding**）或编辑器的上下文菜单访问**折叠**菜单 |命令|快捷键|描述| |---|---|---| |Expand|`Ctrl+NumPad Plus`|展开当前折叠部分| |Collapse|`Ctrl+NumPad -`|折叠当前折叠区域| |Expand Recursively|`Ctrl+Alt+NumPad Plus`|展开当前折叠部分和所有当前部分从属的折叠区域| |Collapse Recursively|`Ctrl+Alt+NumPad -`|折叠当前折叠区域和所有从属于它的折叠区域| |Expand All|`Ctrl+Shift+NumPad Plus`|展开所有选中的折叠区域，如果没有选中任何代码，则展开所有当前页面的折叠部分| |Collapse All|`Ctrl+Shift+NumPad -`|折叠选中区内的所有折叠区域，如果没有选中任何代码，则折叠所有当前页面的折叠区域| |Expand to level 1, 2, 3, 4 or 5|`Ctrl+NumPad *, 1`<br/>`Ctrl+NumPad *, 2`<br/>`Ctrl+NumPad *, 3`<br/>`Ctrl+NumPad *, 4`<br/>`Ctrl+NumPad *, 5`|展开当前片段和所有嵌套的片段到指定级别| |Expand all to level 1, 2, 3, 4 or 5|`Ctrl+Shift+NumPad *, 1`<br/>`Ctrl+Shift+NumPad *, 2`<br/>`Ctrl+Shift+NumPad *, 3`<br/>`Ctrl+Shift+NumPad *, 4`<br/>`Ctrl+Shift+NumPad *, 5`|展开文件中所有折叠的片段到指定级别| |Expand doc comments| |展开当前文档的所有注释| |Collapse doc comments| |折叠当前文档的所有注释 |Fold Selection / Remove region|`Ctrl+.`|展开选中区域并创建一个定制折叠区域来让它可折叠和展开当前片段，或移除定制的折叠区域让它不可折叠| ## <span id='指定代码折叠偏好'>指定代码折叠偏好</span> 你可以指定： * 是否显示代码折叠开关 * 哪种折叠区域应默认折叠 相应的设置在设置对话框(`Ctrl+Alt+S`)的**Editor | General | Code Folding**页面。 更多信息参考[代码折叠页面](/参考/设置参数对话框/编辑器/常规/代码折叠.md) ## <span id='查看折叠的代码片段'>查看折叠的代码片段</span> 要查看折叠部分的代码内容，鼠标指向省略号来显示这部分内容。  ### <span id='查看折叠区域的开始'>查看折叠区域的开始</span> 要查看折叠区域的开始-如果当前看不到-指向目标区域的尾部折叠开关。  ## <span id='使用代码折叠注释'>使用代码折叠注释</span> * [支持折叠注释](#支持折叠注释) * [用折叠注释环绕片段](#用折叠注释环绕片段) * [跳转到折叠区域](#跳转到折叠区域) ### <span id='支持折叠注释'>支持折叠注释</span> 你可以创建自定义折叠区域通过对代码片段环绕注释行。这样做，注释可以是NetBeans风格或Visual Studio风格。 #### NetBeans风格 //<editor-fold desc="Description"> ... //</editor-fold> #### Visual Studio风格 //region Description ... //endregion 一旦当你已经在一个文件中选用一个风格，不要在该文件中使用其它风格的注释。 ### <span id='用折叠注释环绕片段'>用折叠注释环绕片段</span> 1. 选择感兴趣的代码片段 2. 选择**Code | Surround With**或按`Ctrl+Alt+T` 3. 选择要使用的折叠注释  4. 指定片段描述  现在如果你折叠了这个片段，你指定的描述将展现在代码的地方。  ### <span id='跳转到折叠区域'>跳转到折叠区域</span> 你可以跳转到被折叠注释标志包围而形成的折叠区域： 1. 选择**Navigate | Custom Folding**或按`Ctrl+Alt+.` 2. 选择目标折叠区域。(列表中的区域是根据它们的描述形成)  # 另请参阅： 规程： * [代码折叠参考](/参考/设置参数对话框/编辑器/常规/代码折叠.md) 入门指南： * [PhpStorm编辑器](/如何使用/常规指南/PhpStorm编辑器/README.md)