php可折叠注释,使用代码折叠注释 - 使用代码折叠注释 - 《PhpStorm官方手册中文翻译》 - 书栈网 · BookStack...

代码折叠

在这个页面中：

基础

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

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

)

代码折叠方法

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

，

或

)。这些开关显示在编辑器左边相应的折叠区域。如果该区域是展开的，

表示折叠区域的开始，

表示折叠区域的结尾。对于已经折叠的区域，开关显示为

。

如果你按住ALT同时点击(

，

或

，该区域将递归的展开或折叠，例如，连同其所有下属区域。

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

折叠的代码片段：点击

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

折叠预定义和自定义区域

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

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

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

用相应折叠注释标记环绕的区域(例如，//...//)。参见使用代码折叠注释

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

可以通过主菜单的(Code | Folding)或编辑器的上下文菜单访问折叠菜单命令快捷键描述ExpandCtrl+NumPad Plus展开当前折叠部分

CollapseCtrl+NumPad -折叠当前折叠区域

Expand RecursivelyCtrl+Alt+NumPad Plus展开当前折叠部分和所有当前部分从属的折叠区域

Collapse RecursivelyCtrl+Alt+NumPad -折叠当前折叠区域和所有从属于它的折叠区域

Expand AllCtrl+Shift+NumPad Plus展开所有选中的折叠区域，如果没有选中任何代码，则展开所有当前页面的折叠部分

Collapse AllCtrl+Shift+NumPad -折叠选中区内的所有折叠区域，如果没有选中任何代码，则折叠所有当前页面的折叠区域

Expand to level 1, 2, 3, 4 or 5Ctrl+NumPad *, 1

Ctrl+NumPad *, 2

Ctrl+NumPad *, 3

Ctrl+NumPad *, 4

Ctrl+NumPad *, 5展开当前片段和所有嵌套的片段到指定级别

Expand all to level 1, 2, 3, 4 or 5Ctrl+Shift+NumPad *, 1

Ctrl+Shift+NumPad *, 2

Ctrl+Shift+NumPad *, 3

Ctrl+Shift+NumPad *, 4

Ctrl+Shift+NumPad *, 5展开文件中所有折叠的片段到指定级别

Expand doc comments展开当前文档的所有注释

Collapse doc comments折叠当前文档的所有注释

Fold Selection / Remove regionCtrl+.展开选中区域并创建一个定制折叠区域来让它可折叠和展开当前片段，或移除定制的折叠区域让它不可折叠

指定代码折叠偏好

你可以指定：是否显示代码折叠开关

哪种折叠区域应默认折叠

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

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

查看折叠的代码片段

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

来显示这部分内容。

查看折叠区域的开始

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

使用代码折叠注释

支持折叠注释

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

NetBeans风格//

...

//

Visual Studio风格//region Description

...

//endregion

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

用折叠注释环绕片段选择感兴趣的代码片段

选择Code | Surround With或按Ctrl+Alt+T

选择要使用的折叠注释

指定片段描述

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

跳转到折叠区域

你可以跳转到被折叠注释标志包围而形成的折叠区域：选择Navigate | Custom Folding或按Ctrl+Alt+.

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

另请参阅：

规程：

入门指南：