PhpStorm代码折叠设置与快捷键使用技巧

本文详细讲解了如何高效定制 PhpStorm 的代码折叠功能，涵盖从基础设置（启用/禁用函数、类、注释等内置折叠项）到高级技巧（使用 `// region` 自定义折叠块、通过正则表达式精准匹配特殊代码结构），并提供了实用快捷键组合（如一键折叠光标所在区域、展开全部、按层级折叠等），还包含状态重置与设置导出等维护方案——帮助开发者彻底摆脱杂乱代码干扰，大幅提升 PHP 项目编写与阅读效率。

如果您在使用 PhpStorm 编写代码时发现默认的折叠行为不符合开发习惯，例如无法折叠注释块、类成员或自定义代码段，则可能是由于折叠规则未按需配置。以下是设置 PhpStorm 代码折叠规则的具体方法：

一、启用与禁用内置折叠区域

PhpStorm 默认支持多种语言结构的自动折叠，如函数体、类定义、注释、PHPDoc、HTML 标签等。可通过设置开关控制各类折叠区域是否启用。

1、点击顶部菜单栏 File → Settings（Windows/Linux）或 PhpStorm → Preferences（macOS）。

2、在左侧导航树中展开 Editor → General → Code Folding。

3、在右侧列表中勾选或取消勾选对应项，例如 Methods、Classes、Comments、PHPDoc 等。

4、勾选 Show code folding outline 可在编辑器右侧显示折叠区域缩略线。

二、自定义折叠区域（Region Folding）

通过预定义注释标记可创建任意范围的可折叠代码块，适用于临时分组逻辑、屏蔽调试代码或组织大型配置片段。

1、在 PHP 文件中插入如下格式的注释：

// region 描述文字

// endregion

2、将需要折叠的代码置于两行注释之间。

3、保存后，左侧行号旁会出现折叠箭头，点击即可收起该区域。

4、支持嵌套 region，但需确保 endregion 与 region 成对且缩进无关。

三、基于正则表达式的高级折叠配置

对于非标准结构（如特定格式的数组定义、YAML 风格配置块），可通过正则表达式定义折叠起始与结束模式。

1、进入 Settings/Preferences → Editor → General → Code Folding。

2、点击右下角 + Add 按钮。

3、在弹出窗口中填写：
— Start pattern：匹配折叠起始行的正则表达式，例如 ^\s*//\s*BEGIN\s+(.*)$；
— End pattern：匹配折叠结束行的正则表达式，例如 ^\s*//\s*END\s+\1$；
— 勾选 Case sensitive 或 Multiline（如需跨行匹配）。

4、点击 OK 保存规则，重启编辑器或重新打开文件生效。

四、常用折叠快捷键操作

PhpStorm 提供了多组快捷键用于快速控制折叠状态，无需依赖鼠标操作。

1、折叠光标所在区域：Ctrl + .（Windows/Linux）或 Cmd + .（macOS）。

2、展开光标所在区域：Ctrl + Shift + .（Windows/Linux）或 Cmd + Shift + .（macOS）。

3、折叠所有区域：Ctrl + Shift + -（Windows/Linux）或 Cmd + Shift + -（macOS）。

4、展开所有区域：Ctrl + Shift + +（Windows/Linux）或 Cmd + Shift + +（macOS）。

5、折叠指定层级（如仅折叠类、不折叠方法）：Ctrl + Alt + T 后选择 Fold by folding group。

五、重置折叠状态与持久化设置

PhpStorm 默认会记住每个文件的折叠状态，但有时因缓存异常导致折叠错乱，需手动干预恢复。

1、清除当前文件所有折叠状态：Ctrl + Alt + NumPad -（Windows/Linux）或 Cmd + Option + -（macOS）。

2、强制刷新当前文件折叠结构：Ctrl + F5（Windows/Linux）或 Cmd + F5（macOS）。

3、若希望新创建文件默认启用某类折叠（如 always fold comments），需在 Code Folding 设置页勾选对应项并点击 Apply。

4、配置导出：点击设置页右下角 Export Settings 可备份当前折叠规则，供其他工作环境导入。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。