PHPStorm 默认启用基础代码折叠，需在 Settings → Editor → General → Code Folding 中勾选 Functions、Classes、Comments、Imports 等选项，并取消 Collapse by default；trait、匿名函数、数组等需单独启用对应选项，且依赖 PHP 语言级别和插件兼容性。
PHPStorm 中如何开启和自定义代码块折叠
PHPStorm 默认已启用基础代码折叠（如函数、类、注释），但很多用户实际用不到，是因为关键设置被关掉了，或者没意识到折叠行为受语言注入、插件或文件类型影响。
确认是否生效：打开一个 .php 文件，把光标放在某个 function 或 class 关键字上，按 Ctrl + Shift + -（Windows/Linux）或 Cmd + Shift + -（macOS）——如果没反应，大概率是折叠规则被禁用了。
- 进入
Settings / Preferences → Editor → General → Code Folding - 勾选
Enable folding for下的Functions、Classes、Comments、Imports（PHP 中对应use语句） - 特别注意：取消勾选
Collapse by default—— 否则新打开文件会自动折叠所有可折叠块，反而干扰阅读 - 若想对
if、foreach等控制结构也支持折叠，需勾选Control flow statements（PHP 支持，但性能敏感时建议慎开）
为什么有些代码块无法折叠（比如 trait、匿名函数、数组字面量）
PHPStorm 的折叠能力依赖于语言解析器的 AST 节点识别。不是所有语法结构都被默认视为“可折叠单元”，尤其 PHP 中较新的语法或嵌套结构容易被忽略。
-
trait块默认不折叠，需手动在Code Folding设置中勾选Traits - 匿名函数（
function () { ... }）和箭头函数（fn() => ...）在 2023.2+ 版本才被支持折叠，旧版本即使勾选Functions也无效 - 长数组（尤其是多维关联数组）需单独勾选
Arrays，否则[...]不会折叠；但开启后可能误折叠短数组（如['a', 'b']），建议配合Minimum length to fold设为 5 行以上 - 如果用了 PHPDoc 注解（如
@return）、属性类型（public string $name;）或构造函数属性提升（public function __construct(private string $id)），确保 PHP 语言级别设为对应版本（Settings → Languages & Frameworks → PHP），否则解析失败导致折叠失效
如何快速展开/折叠当前层级或整个文件
靠快捷键逐个操作效率低，真正提升阅读体验的是「范围化」折叠控制。
- 折叠全部：按
Ctrl + Shift + NumPad -（主键盘区减号不行，必须用数字小键盘） - 展开全部：按
Ctrl + Shift + NumPad + - 只折叠当前光标所在区域（比如只收起当前
class，不管外面的namespace）：先按Ctrl + .（点号）激活「Fold current region」，再按Ctrl + Shift + - - 鼠标悬停在折叠标记（左侧灰色竖线上的
[-]）时，按住Alt键可临时展开该块（松手即恢复），适合快速扫读内部逻辑 - 右键折叠标记 →
Fold recursively可递归折叠子块（如类里每个方法都收起），但慎用，容易陷入“找不到哪段代码在哪”的状态
插件或配置冲突导致折叠失效的排查点
常见于装了 PHP Annotations、Laravel Idea、PHP Toolbox 等插件后，折叠突然变弱或错位。
- 检查
Settings → Editor → Color Scheme → General → Code Folding中的图标颜色是否被设为透明或与背景一致（看起来像“没折叠”） - 禁用所有第三方插件，重启 PHPStorm，测试折叠是否恢复；逐个启用定位问题插件
- 某些项目启用了
PSR-12或自定义代码风格，若格式化后换行异常（如function声明后多空行），可能导致折叠边界识别失败 - 缓存问题：执行
File → Invalidate Caches and Restart → Invalidate and Restart，特别是升级 PHPStorm 后出现折叠异常时，这一步解决过半数案例
折叠不是越深越好，过度折叠会让代码结构感消失；建议只对明确的逻辑单元（类、方法、大段配置数组）启用，而保留条件分支、循环体可见——毕竟你真正想跳过的，从来不是 if，而是它里面那 30 行数据处理逻辑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
