PhpStorm默认不折叠函数/类，需在Settings→Editor→General→Code Folding→Advanced Settings→PHP中勾选Functions、Classes、Doc comments；// region折叠须启用Custom folding regions且格式严格；trait等结构需对应版本及单独启用。
PhpStorm 默认不会自动折叠函数或类，必须手动启用对应语言规则，否则 Ctrl + - 之类快捷键完全没反应。
怎么让 function 和 class 支持折叠
关键不是“开启代码折叠”，而是开启 PHP 专属的折叠项。默认勾选的 Functions 和 Classes 是通用语言规则，对 PHP 文件无效。
- 进入
Settings / Preferences → Editor → General → Code Folding - 滚动到底部，点击
Advanced Settings展开 - 在
PHP区域下，勾选Functions、Classes、Doc comments（PHPDoc 注释块很有用） - 确认右下角状态栏显示的
PHP Language Level≥ 7.4；若显示Plain Text或HTML，折叠规则不加载
如果仍不生效，检查函数声明是否跨行异常（比如 function 单独一行，name() 在下一行），或文件开头缺 <?php。
// region 折叠为什么点了没反应
根本原因是 Custom folding regions 默认关闭，且格式校验极严——错一个空格就失效。
立即学习“PHP免费学习笔记（深入）”；
- 必须在
Code Folding设置中勾选Custom folding regions -
// region和// endregion必须独占一行，前后不能有空格、缩进、代码或注释 - 不支持
/* region */、# region或嵌套写法（// region A里再写// region B会错乱） - 示例正确写法：
// region 数据处理逻辑 $data = []; $result = process($data); // endregion
为什么 trait、匿名函数、长数组不折叠
这些不是“不支持”，而是需要单独启用，且受版本和语言级别双重限制。
-
Traits：在Advanced Settings → PHP下有独立选项，旧版本默认未勾选 - 匿名函数
function () { }和箭头函数fn() =>：仅PhpStorm 2023.2+支持，勾选Functions不够，得确认版本 - 长数组（尤其多维关联数组）：需勾选
Arrays，并建议设置Minimum length to fold≥ 5 行，避免误折叠['a', 'b']这类短数组 - 如果用了构造函数属性提升（
public function __construct(private string $id)），PHP 语言级别必须设为 8.0+，否则解析失败导致折叠失效
折叠后光标乱跳、跳转失效怎么办
折叠本身不影响执行或分析，但会干扰导航体验，尤其在结构复杂时容易被忽略。
- 折叠时光标“跳行”是锚点机制导致的：它试图把折叠起始行保持在视口垂直居中。解决办法是折叠前把光标移到该行首/尾，或直接点行号旁的三角符号（不触发重定位）
-
use语句折叠后，Ctrl + Click跳转可能失效——建议禁用PHP → Use statements折叠 - 批量操作推荐用数字小键盘快捷键：
Ctrl + Shift + NumPad -（全折叠）、Ctrl + Shift + NumPad +（全展开），比主键盘减号更稳定 - 按住
Alt（macOS 为Option）再点折叠箭头，可递归展开/折叠整个嵌套层级，查深层逻辑时很关键
最常被忽略的是：即使所有设置都对，只要文件被识别为 Text 或 Vue SFC Script 模式，PHP 折叠规则就完全不加载——务必盯紧右下角语言标识。
