PhpStorm中用Live Template实现选中代码自动包裹，需创建含$SELECTION$的模板（如wrapdd），勾选PHP上下文及Reformat according to style；触发前必须选中代码，否则$SELECTION$为空；多光标操作需配合Ctrl+Alt+T调用Surround With。
怎么在 PhpStorm 里用 Live Template 实现“选中代码 → 按快捷键 → 自动包裹”
PhpStorm 本身不叫“宏”，但用 Live Template + $SELECTION$ 变量就能达成完全一样的效果，而且更稳定、可复用、支持参数化。别去折腾老旧的 Macro Recorder（它不支持上下文感知，也早被弃用）。
常见错误是：新建模板后没勾选 Reformat according to style，导致包裹后缩进错乱；或者忘了把 Applicable in 设为 PHP 或 Everywhere，结果快捷键根本不出现在右键菜单里。
- 打开
Settings → Editor → Live Templates - 点
+→Live Template - Abbreviation 填个短命令，比如
wrapdd（代表 wrap withdd()） - Template text 填：
dd($SELECTION$);
- 点
Define，勾选PHP（或按需选其他语言） - 勾选
Reformat according to style和Shorten FQ names
为什么 $SELECTION$ 必须写在模板里，不能靠“先选中再触发”自动注入
因为 PhpStorm 的 Live Template 触发逻辑是“先匹配 abbreviation，再展开”，不是“先选中再找动作”。如果模板里没写 $SELECTION$，它就当普通片段插入，不会把你刚选中的内容塞进去。
典型错误现象：wrapdd 按完只出来 dd();，中间空着——说明你漏写了 $SELECTION$，或者写成了 $selection$（大小写敏感）。
立即学习“PHP免费学习笔记（深入）”；
-
$SELECTION$是唯一能捕获当前选中文本的内置变量，大小写必须全大写 - 如果想加换行或缩进，直接在模板里敲回车和空格就行，比如：
if (true) {<br> $SELECTION$<br>} - 不支持嵌套
$SELECTION$，比如foo($SELECTION$, $SELECTION$)会报错，得用foo($SELECTION$, $SELECTION$)？不行，得手动复制粘贴两次
怎么让包裹操作支持“多光标选中多段代码，一次全包”
Live Template 本身不支持多光标批量处理，但你可以用 Multiple Carets 配合 Ctrl+Alt+T（Windows/Linux）或 Cmd+Alt+T（macOS）快速触发包裹 —— 这个快捷键才是 PhpStorm 原生的“包裹代码”入口，比自定义模板更灵活。
它的本质是调用 Surround With 功能，背后是预置的模板（如 if、try/catch），但你也可以往里面加自己的模板。
- 选中一段代码 → 按
Ctrl+Alt+T→ 弹出菜单里选你刚定义的wrapdd - 想对多处同时操作？先用
Alt+J（逐个加选）或Ctrl+G（查找全部匹配并多选），再按Ctrl+Alt+T，它会为每个选区单独执行一次包裹 - 注意：多光标下如果某处没选中内容，
$SELECTION$会变成空，可能生成dd();，要提前检查
包裹时怎么动态加注释或日志前缀（比如加上文件名和行号）
Live Template 支持函数式变量，比如 fileName()、lineNumber()，但它们不能直接拼在 $SELECTION$ 外面做“包裹”，得靠模板结构硬编码。
例如，想要输出 // [index.php:123] debug: xxx，就得把整个结构写死在模板里：
/* [${fileName()}:${lineNumber()}] debug */ $SELECTION$注意：fileName() 返回的是带扩展名的文件名（如 index.php），不是路径；lineNumber() 返回的是模板展开时的当前行号，不是选中代码的起始行。
- 可用变量有：
fileName()、lineNumber()、date()、user()，不支持自定义函数 - 如果需要“选中内容前后都加东西”，比如注释块，就写成：
/* === START === */<br>$SELECTION$<br>/* === END === */
- 别指望用变量控制是否包裹——Live Template 没条件判断，要分支逻辑得写插件
实际用多了就会发现，最麻烦的不是设模板，而是每次改完要手动点 Apply 才生效；还有就是团队协作时，这些模板默认不共享，得导出 liveTemplates.xml 文件手动同步。
