新打开的PHP文件自动折叠use块需两步：勾选PHP→Use statements折叠规则，并启用Enable folding for newly opened files开关；常见失效原因包括语言模式错误、BOM/空行、低版本不支持use function/const等。
怎么让新打开的 PHP 文件自动折叠 use 块
关键不是“默认折叠”，而是两步都得做对：启用 PHP 的 Use statements 折叠规则 + 开启全局自动应用开关。
进入 Settings / Preferences → Editor → General → Code Folding，在列表中找到并勾选 PHP → Use statements；再往下滚动，务必勾选底部的 Enable folding for newly opened files（这个选项默认是关的）。
常见失效原因：
- 当前文件右下角显示的语言模式不是
PHP（比如被识别为Text或Vue SFC Script），折叠规则不匹配 - 文件开头有 BOM 或首行为空，导致 PSI 解析异常，
use区块无法被识别为可折叠单元 - 用了
use function或use const语法，需 PhpStorm 2023.1+ 版本才支持折叠
为什么取消 Collapse by default 反而更实用
勾选 Collapse by default 看似省事，实际会干扰日常阅读——新打开一个类文件，所有 function、class、comments 全部收起，你得先手动展开才能看清结构。
立即学习“PHP免费学习笔记（深入）”；
更合理的做法是：
- 保持
Collapse by default未勾选（即默认展开） - 只开启具体语言项，如
PHP → Functions、PHP → Classes、PHP → Doc comments - 配合快捷键按需折叠：
Ctrl + .（光标所在块）、Ctrl + Shift + NumPad -（全部折叠）
这样既保留结构可见性，又不牺牲快速收放能力。
region 折叠为什么写了 // region 还是不生效
根本原因是 Custom folding regions 默认关闭，且格式容错极低。
必须同时满足三个条件：
- 在
Code Folding设置中勾选Custom folding regions -
// region和// endregion必须独占一行，前后不能有空格、缩进或代码 - 不能混用其他注释风格，例如
/* region */或# region都无效
示例正确写法：
// region 数据处理逻辑 $data = [...]; $result = process($data); // endregion
trait、匿名函数、长数组为什么默认不折叠
这些结构不是“被忽略”，而是需要显式启用对应折叠项，且受 PhpStorm 版本和 PHP 语言级别限制。
操作路径仍是 Settings → Editor → General → Code Folding → Advanced Settings → PHP，但要注意：
-
Traits：单独有一项，旧版本默认不勾选 - 匿名函数（
function () { }）和箭头函数（fn() =>）：仅 2023.2+ 支持，勾选Functions不够，必须确认版本 -
Arrays：启用后会折叠所有数组字面量，但可通过Minimum length to fold设为 5 行以上，避免误折叠['a', 'b'] - 如果用了构造函数属性提升（
public function __construct(private string $id)），PHP 语言级别必须设为 8.0+，否则 AST 解析失败，折叠直接失效
最易被忽略的一点：折叠行为依赖 PSI 结构完整性。哪怕文件里只有一个未闭合括号，整个 use 块或 class 都可能失去折叠能力——别急着调设置，先检查语法错误。
