PhpStorm中手动折叠/展开代码需用Ctrl+.（Win/Linux）或Cmd+.（macOS），选中多行可折叠为一块；region折叠须在设置中启用且格式严格；折叠仅为视觉隐藏，提交前应展开检查。
怎么手动折叠/展开某段代码
PhpStorm 默认支持按结构自动折叠，但有时你想临时收起一段逻辑（比如大段配置数组、注释掉的旧代码），又不想删或加 //。直接用快捷键最稳：Ctrl + .（Windows/Linux）或 Cmd + .（macOS）对光标所在行生效；选中多行再按，会把选区当做一个折叠块。
注意：这个操作依赖代码结构识别。如果写的是纯文本块、没被解析为合法语法（比如 JSON 字符串里硬塞 PHP 语法），Ctrl + . 会没反应——不是功能坏了，是 PhpStorm 根本没把它当“可折叠单元”。
- 函数体、类定义、
if/for块天然支持折叠 - 注释块（
/* ... */或连续//）默认可折叠，但需在Settings > Editor > General > Code Folding中勾选Line comments和Block comments - 自定义区域（如
// region foo/// endregion）必须显式开启，否则不识别
为什么 // region 折叠不生效
很多人照着网上教程写 // region 初始化逻辑，结果右键菜单里没有“Fold Region”，甚至快捷键也不响应。根本原因是：PhpStorm 默认关闭了 region 折叠支持，且对格式极其敏感。
- 必须在
Settings > Editor > General > Code Folding中勾选Custom folding regions -
// region和// endregion必须独占一行，前后不能有空格或代码 - 不支持嵌套（
// region A里面再写// region B会导致折叠错乱） - PHP 文件中更推荐用
#region和#endregion（部分版本对//解析不稳定）
示例正确写法：
立即学习“PHP免费学习笔记（深入）”；
// region 数据校验
if ($input === null) {
throw new InvalidArgumentException();
}
// endregion折叠后代码被误删或提交了怎么办
折叠只是视觉隐藏，不影响运行和 Git 提交。但人眼容易忽略折叠块里的内容，尤其在快速滚动、Code Review 或合并冲突时。最常出问题的是：改了折叠块外的逻辑，却忘了里面有个 $cache = []; 被重置了，或者漏看了折叠里的 return false;。
- 提交前按
Ctrl + Shift + .（Windows/Linux）或Cmd + Shift + .（macOS）一键展开全部，扫一眼有没有异常缩进或突兀的return - Git diff 里看不到折叠状态，所有代码都会显示，但如果你用 IDE 内置的 Commit 窗口，它默认只高亮“可见行”——记得点右上角
Show all changes - 团队协作时，避免用 region 包裹关键逻辑（比如权限检查、日志上报），别人打开文件第一眼看不到，容易跳过
PHP 8.1+ 属性折叠异常（如 #[\Attribute]）
升级到 PHP 8.1 后，带属性（#[\Attribute]）的类、方法如果被折叠，偶尔会出现展开后光标错位、语法高亮丢失，甚至报 Cannot resolve symbol。这不是 bug，是 PhpStorm 的 AST 解析器对新语法的折叠粒度还没完全对齐。
- 临时方案：在
Settings > Editor > General > Code Folding中取消勾选Attributes - 长期建议：保持 PhpStorm 更新到最新小版本（2023.3.4+ 对 PHP 8.2 属性折叠修复较多）
- 别用 region 包裹单个属性——比如
// region套#[Route("/api")]，这种折叠既没意义又容易触发解析抖动
折叠本质是编辑器帮你“暂时忽略”，但它不会替你判断哪段该看、哪段该信。越关键的逻辑，越要让它裸着——哪怕多滚两下鼠标。
