<p>注释折叠需手动启用：Settings→Editor→General→Code Folding中勾选Comments（管//）和Block comments（管/ /），否则Ctrl+.等快捷键无效；Doc comments仅针对/* /，与Comments独立；混入PHP代码或文件类型误判会导致折叠失败。</p>
注释折叠不是默认开启的，得手动勾选
PhpStorm 默认对 Comments 折叠是关闭状态，哪怕你写了大段 PHPDoc 或多行 // 注释，Ctrl + . 或 Ctrl + Shift + - 都不会收起它们——不是快捷键失效，而是规则没启用。
进 Settings → Editor → General → Code Folding，找到并勾选 Comments（注意不是 Doc comments，那是专指 PHPDoc 的子选项）；如果还想折叠 /* ... */ 块注释，还得额外勾选 Block comments。
- 勾选后，已存在的注释块不会自动折叠，需手动触发或重启编辑器才生效
-
Doc comments和Comments是两个独立开关：前者只管/** ... */，后者管所有单行//和部分内联注释 - 若注释里混了 PHP 语法（比如
// $arr = [1, 2, 3];），PhpStorm 可能拒绝折叠——它只认“纯注释”，不解析内容
展开/收起全部注释的快捷键组合
没有单独针对“注释”的全局折叠快捷键，但可以用通用命令精准控制：
- 收起当前文件中所有可折叠单元（含已启用的注释）：
Ctrl + Shift + NumPad -（必须用数字小键盘减号，主键盘区-无效） - 展开全部：
Ctrl + Shift + NumPad + - 只收起光标所在注释块：
Ctrl + .（点号），前提是该注释已被识别为折叠单元（即上一步已启用Comments） - 按住
Ctrl点击左侧折叠标记（▶），可逐个展开/收起，比快捷键更可控
注意：Ctrl + Shift + - 在某些键盘布局下会触发系统音量调节，务必确认用的是 NumPad 区域。
立即学习“PHP免费学习笔记（深入）”；
为什么有些注释死活不折叠？常见排雷点
不是所有带 // 的行都能被当注释处理，PhpStorm 依赖语法解析器判断上下文：
- PHP 文件里写了一段 JSON 字符串，里面包含
//——这会被当字符串内容，不触发注释折叠 - 在
heredoc或nowdoc里写的//同样无效，因为不在 PHP 解析上下文中 - 注释末尾有空格或制表符（如
// todo），可能导致折叠识别失败，建议用Ctrl + Alt + L先格式化 - 文件类型被误判为
Text或Plain Text（右下角状态栏显示不对），此时所有语言相关折叠都失效，点状态栏手动切回PHP
批量清理注释视野前，先确认是否真要收起来
折叠注释只是视觉隐藏，不影响执行、调试或 Git 提交。但容易忽略的是：折叠后，Ctrl + F 查找仍会命中被收起的注释内容，而 Ctrl + Shift + F 全局搜索默认不跳过折叠区域——这意味着你以为“清屏了”，其实搜索结果里还躺着几十条被藏起来的 // TODO。
真正影响阅读体验的，往往是注释和代码混排导致的逻辑断层。比起盲目折叠，更值得做的是：用 Ctrl + / 批量删掉临时调试注释，或把长期保留的说明移到 PHPDoc 里，再统一启用 Doc comments 折叠——这样既干净，又保住了语义结构。
