PhpStorm怎么用自定义宏批量包裹代码-phpstorm-PHP中文网

PhpStorm中用Live Template实现选中代码自动包裹，需创建含$SELECTION$的模板（如wrapdd），勾选PHP上下文及Reformat according to style；触发前必须选中代码，否则$SELECTION$为空；多光标操作需配合Ctrl+Alt+T调用Surround With。

phpstorm怎么用自定义宏批量包裹代码

怎么在 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 with dd()）
Template text 填：
```
dd($SELECTION$);
```
点 Define，勾选 PHP（或按需选其他语言）
勾选 Reformat according to style 和 Shorten FQ names

为什么 $SELECTION$ 必须写在模板里，不能靠“先选中再触发”自动注入

因为 PhpStorm 的 Live Template 触发逻辑是“先匹配 abbreviation，再展开”，不是“先选中再找动作”。如果模板里没写 $SELECTION$ ，它就当普通片段插入，不会把你刚选中的内容塞进去。

典型错误现象：wrapdd 按完只出来 dd();，中间空着——说明你漏写了 $SELECTION$ ，或者写成了 $selection$ （大小写敏感）。

$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），但你也可以往里面加自己的模板。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

选中一段代码 → 按 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 文件手动同步。