phpstorm默认不折叠php多行注释（/.../），必须在settings→editor→general→code folding中手动勾选block comments；若未启用、注释嵌套php代码或文件被误识别为html/twig模板，则折叠无效。
PhpStorm 默认不折叠 PHP 多行注释（/* ... */），必须手动启用对应规则，否则即使选中按 Ctrl + . 也无效。
多行注释 /* ... */ 折叠不生效的常见原因
不是 PhpStorm 不支持，而是它把 /* ... */ 和 // 注释分开处理，且默认禁用前者：
-
/* ... */归类为 Block comments，而//是 Line comments，两者开关独立 - Settings → Editor → General → Code Folding 中，默认只勾选了
Line comments，Block comments是未勾选状态 - 如果注释里嵌套了 PHP 代码（如
/* <?php echo 'x'; ?> */），解析器可能跳过整块，导致无法折叠 - 文件被识别为 HTML 或 Twig 模板（顶部无
<?php或混有<div>），PHP 折叠规则压根不加载<h3>启用 <code>/* ... */折叠的实操步骤进入
Settings / Preferences → Editor → General → Code Folding，确认以下三项已勾选：-
Block comments（核心项，专管/* ... */） -
PHPDoc blocks（顺带覆盖/** ... */文档注释，常用于函数说明） -
Show code folding outline（右侧边栏显示缩略线，方便快速定位折叠区）
无需重启，改完即生效。折叠后鼠标悬停三角会显示注释首行内容（如
/* 初始化配置参数 */）。
phpstorm 2026.1 Mac下载PhpStorm 2026.1 Mac 版已针对 Apple Silicon（M1/M2/M3/M4）芯片进行原生优化，实现了极速启动与流畅运行。该版本不仅深度适配 Laravel 13 与 Livewire 框架，还创新性地集成了 MCP 服务器，允许开发者直接在 IDE 内调用 Claude Code 等 AI 智能体辅助编程。配合优化的索引机制与 macOS 原生界面风格，它为 Mac 用户
Ctrl + .对多行注释无效？检查这几点该快捷键本质是“折叠当前选区”，但对注释块有前置条件：
- 光标必须落在
/*开头行，或整个/* ... */块已被正确选中（含换行符） - 注释不能跨文件语言边界——例如在 Blade 模板里写
/* @endphp */，会被当成 HTML 注释，PHP 规则不生效 - 若注释内含语法错误（如漏写
*/），PhpStorm 解析失败，直接拒绝折叠 - 旧版 PhpStorm（2022.x 及更早）对嵌套注释（
/* /* inner */ outer */）支持不稳定，建议避免
比注释折叠更干净的替代方案
纯视觉收起大段说明性文字，
// region更可控：- 写法严格：
// region 配置说明和// endregion必须独占一行、无空格、无缩进 - 需先在 Code Folding 设置中勾选
Custom folding regions，否则无视 - 优势：不受 PHP 版本限制，不依赖注释语法合法性，折叠摘要可自定义（如
// region 数据校验逻辑） - 注意：不兼容
/* region */或# region，仅认双斜杠格式
真正容易被忽略的是：折叠只是视觉隐藏，Git 提交前务必展开检查——尤其当注释里藏了临时调试代码或 TODO 时，一折叠就看不见了。
-
