PhpStorm无“批量代码包裹”功能，需用块注释（Ctrl+Shift+/）、Live Templates（如wrap0模板）或多光标编辑实现；关键在精准选中、保持缩进、避免语法破坏。
PhpStorm 本身没有叫“批量代码包裹”的独立功能，但你真正需要的，是用块注释、Live Templates 或多光标编辑，把选中代码快速套进 /* */、if (0) { }、try { } 这类结构里——关键不在“包裹”动作本身，而在选中范围是否精准、包裹后缩进是否干净、是否误伤上下文。
用 Ctrl+Shift+/ 快速套 /* */ 块注释
这是最常用也最容易翻车的操作：你以为在包裹代码，其实只是加了注释符号，而 IDE 默认会自动缩进、换行、对齐，稍不注意就让代码变形。
- 必须先选中目标代码（支持跨空行、跨函数），不能只把光标停在某一行
- 按
Ctrl + Shift + /（Windows/Linux）或Cmd + Shift + /（macOS）后，PhpStorm 会在选区首尾插入/*和*/，并尝试把每行内容缩进到同一层级——但若原代码本身缩进混乱，结果可能更糟 - 如果选区包含已有注释（比如某行末尾有
// todo），它不会帮你清理，而是直接包进去，导致嵌套注释失效 - 想取消包裹？再次选中已注释区域，再按一遍
Ctrl + Shift + /，它会识别并移除/* */，但不会还原被它改过的缩进
用 Live Templates 实现自定义包裹（如 if (0) { $SELECTION$ }）
这才是真正意义上的“包裹”：把选中内容原样塞进任意模板结构里，不改动缩进逻辑，也不依赖注释语义。
- 进
Settings → Editor → Live Templates，点+ → Live Template - Abbreviation 填个短名，比如
wrap0；Template text 写：if (0) { $SELECTION$ }；勾选Reformat according to style（可选）和Expand with设为Tab - 点右下角
Define，只勾PHP（别漏掉！否则在 .php 文件里不触发） - 使用时：选中代码 → 按
Ctrl + J（Windows/Linux）或Cmd + J（macOS）→ 输入wrap0→ Tab 确认 - ⚠️ 注意：
$SELECTION$是唯一占位符，不能写成${SELECTION}或$selection$；且模板必须放在User组下，否则导出/同步时容易丢失
用多光标 + 手动输入实现灵活包裹
当你要包裹的结构不固定（比如有时是 dd($x)，有时是 Log::debug($x)），Live Templates 反而太重，这时多光标更直接。
立即学习“PHP免费学习笔记（深入）”；
- 选中要包裹的多行变量/表达式（例如三行分别写着
$user、$order、$payment） - 按
Ctrl + Shift + Alt + J（Windows/Linux）或Cmd + Shift + Option + J（macOS）一键为所有匹配项加光标 - 在每行开头输入
dd(，结尾统一补)（可用End键跳到行尾，再输） - 如果包裹结构含换行（如
try { $SELECTION$ }），建议先用列选择（Alt + Shift + 鼠标拖选）在每行末尾加回车和缩进，再统一补大括号 - ⚠️ 别在未选中状态下用
Ctrl + Ctrl触发多光标——它会匹配全文所有相同文本，极易误操作
为什么“包裹后代码跑不起来”？常见缩进陷阱
包裹操作本身不报错，但 PHP 对缩进虽不敏感，对结构却极其敏感。很多“包裹完执行异常”，其实是缩进破坏了语法边界。
-
/* */包裹后，若原代码有return在行首，包裹会导致它变成/* return ... */，但 IDE 自动缩进可能把它推到第二行，造成语法错位 - Live Template 中没勾
Reformat according to style，$SELECTION$插入后可能顶格，而包裹结构本身有缩进，结果像这样：if (0) { $user }→ 实际生成：if (0) { $user }（看着一样，但若$user原本缩进是 4 空格，现在可能是 0，PHP 解析无问题，但团队规范会打回来） - 用多光标在行尾加
)时，若某行末尾有空格或制表符，光标可能停在空白处而非字符后，导致)插入位置错误
真正难的不是怎么裹，而是裹完之后，那几行代码是否还在它该在的语法层级上——这得靠你盯着编辑器右侧的缩进参考线，而不是只看视觉对齐。
