PhpStorm代码折叠可通过五步配置：一、在Settings/Preferences→Editor→Code Folding中启停内置折叠项；二、用// region…// endregion自定义折叠块；三、通过正则添加高级折叠规则；四、使用快捷键快速折叠/展开；五、重置状态或导出设置。
如果您在使用 PhpStorm 编写代码时发现默认的折叠行为不符合开发习惯，例如无法折叠注释块、类成员或自定义代码段，则可能是由于折叠规则未按需配置。以下是设置 PhpStorm 代码折叠规则的具体方法：
一、启用与禁用内置折叠区域
PhpStorm 默认支持多种语言结构的自动折叠，如函数体、类定义、注释、PHPDoc、HTML 标签等。可通过设置开关控制各类折叠区域是否启用。
1、点击顶部菜单栏 File → Settings（Windows/Linux）或 PhpStorm → Preferences（macOS）。
2、在左侧导航树中展开 Editor → General → Code Folding。
立即学习“PHP免费学习笔记（深入）”；
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 可备份当前折叠规则，供其他工作环境导入。
