PhpStorm 中选中代码后按 Ctrl+Alt+T（Win/Linux）或 Cmd+Alt+T（macOS）即可调用内置「Surround With」功能，自动匹配上下文提供 if、try/catch 等包裹选项；若不生效，先确认文件类型正确且已选中有效代码。
PhpStorm 里怎么给选中代码加 if、try/catch 这类包裹？
直接用 Ctrl+Alt+T（Windows/Linux）或 Cmd+Alt+T（macOS），这是 PhpStorm 内置的「Surround With」功能快捷键，不是要自己配——很多人卡在这步，以为得进设置里找“包围快捷键”选项，其实它默认就开着。
触发后弹出的菜单里会自动过滤当前上下文支持的结构：比如光标在函数体内，就不会显示 class；选中的是表达式，if 和 return 就会高亮优先出现。
- 如果没反应，先检查是否选中了有效代码（空行、纯注释不触发）
- Mac 用户注意：别按成
Cmd+T（那是「Go to Class」） - 菜单项右侧带 ⚡ 图标的，表示支持“智能插入”，比如加
try/catch时会自动把异常变量名设为$e，且光标停在catch块内可直接编辑
想改快捷键或加自定义包裹模板（比如 dd() 或日志包装）？
进 Settings > Keymap，搜索 Surround With，右键它可「Add Keyboard Shortcut」。但更实用的是加自定义模板——这能解决“每次都要手动敲 Log::debug(...)”这种重复操作。
路径：Settings > Editor > Live Templates → 点右上角 + → 选 Template Group（比如叫 surround）→ 再点 + → 选 Live Template：
立即学习“PHP免费学习笔记（深入）”；
-
Abbreviation填logd -
Description写 “Wrap with Log::debug” -
Template text填：Log::debug('$SELECTION$'); - 勾选
Reformat according to style和Shorten FQNs - 点
Define→ 选PHP - 点
Edit variables→ 把SELECTION的Expression设为selection()，Default value留空
之后选中代码，按 Ctrl+Alt+T，就能在列表里看到 logd 选项了。
为什么有时 Ctrl+Alt+T 弹出的菜单里没有想要的选项？
不是插件问题，大概率是语言上下文不匹配。比如你在 Blade 模板里写 PHP 代码，但当前文件类型被识别为 HTML 而非 PHP，if、foreach 这些 PHP 包裹项就不会出现。
- 看右下角状态栏，确认文件类型是
PHP（不是Text或Blade） - 如果是 Blade 文件，PhpStorm 默认只对
@php ... @endphp块内启用 PHP 上下文，普通<?php ... ?>可能被忽略——这时要把Settings > Editor > File Types里PHP的注册模式加上*.blade.php - 模板里用了
@{{ }}或v-if，PhpStorm 会切到 Vue/JS 上下文，PHP 包裹自然消失
性能和兼容性要注意什么？
Live Template 包裹本身没性能损耗，但模板里如果调用复杂函数（比如 generateUuid()）或含外部依赖，会导致弹窗卡顿甚至失败——所有模板逻辑都在 IDE 进程里同步执行。
- 避免在
Template text里写多行 PHP 执行逻辑，只做纯文本替换 - PhpStorm 2022.3+ 对
SELECTION变量支持更好，老版本（如 2020.1）可能无法正确获取选中内容，建议升级 - 团队协作时，自定义模板不会自动同步，得导出
File > Export Settings里的Live Templates部分，再导入
最常被忽略的是文件类型识别——哪怕只差一个点，比如 .php 写成 .phtml，Ctrl+Alt+T 就可能完全失灵。先盯住右下角那个小标签。
