Ctrl+Alt+T（Win/Linux）或 Cmd+Alt+T（macOS）是 PhpStorm 内置的 Surround With 快捷键，无需配置；它动态提供 if、try/catch 等上下文相关包裹选项，要求选中有效 PHP 语句且文件类型正确。
Ctrl+Alt+T（Windows/Linux）或 Cmd+Alt+T（macOS）就是快捷键，不是要自己配
很多人卡在第一步：反复进 Settings 搜“包围”“wrap”“surround”，其实 Ctrl+Alt+T（Win/Linux）或 Cmd+Alt+T（macOS）是 PhpStorm 原生启用的快捷键，无需任何配置。它调用的是内置的 Surround With 功能，不是插件、也不是扩展。
常见误操作包括：
- 按成了
Cmd+T（macOS 上这是「Go to Class」，完全无关） - 选中了空行或纯注释——
Surround With只对有效语句响应 - 文件右下角显示
Text或Plain Text，说明未识别为 PHP，需右键 →Override File Type→ 选PHP
选中代码后菜单不出现 try/catch？检查上下文合法性
Surround With 菜单会动态过滤选项，不是所有结构都永远可见。能否看到 try/catch 取决于当前选区是否构成一个可执行的 PHP 语句单元。
典型失效场景：
立即学习“PHP免费学习笔记（深入）”；
- 只选中
$user->这种不完整表达式（缺方法调用或赋值右值） - 光标在
class或function声明顶层，但没选中内部具体语句（如echo、file_get_contents()） - 选中内容跨函数/类边界（比如从函数体里一直拖到外面的
}），导致语法分析失败
验证方式：把光标停在某行有效语句上（比如 return $data;），按 Ctrl+Alt+T，看菜单是否弹出——如果出现，说明环境正常；否则先修复选区。
包裹后 catch 默认用 \Exception，PHP 7+ 必须手动改成 \Throwable
PhpStorm 默认生成的是 catch (\Exception $e)，但它在 PHP 7+ 中无法捕获 Error 类型（如 TypeError、FatalError），实际运行时会直接崩溃。
两种改法：
- 手动改：在生成的
catch行，把\Exception删掉，输入\Throwable，IDE 会自动补全并加use语句（如果尚未声明） - 一劳永逸：进
Settings → Editor → Live Templates → PHP → surround，找到tryc模板，把\Exception替换为\Throwable
注意：\Throwable 是接口，兼容所有可捕获异常和错误，PHP 7.0+ 唯一推荐写法。
包裹后缩进错乱？立刻补上 Ctrl+Alt+L 格式化
Surround With 只插入结构，不做格式调整。尤其当原代码有混合缩进（空格+Tab）、或多层嵌套时，新插入的 try 和 catch 块常会缩进错位，甚至贴着左边顶格。
解决办法非常简单：
- 包裹完成后，立刻按
Ctrl+Alt+L（Win/Linux）或Cmd+Alt+L（macOS）触发Reformat Code - 如果想让格式化更智能，可在
Settings → Editor → Code Style → PHP里确认Use tab character和Tab size与团队规范一致
真正容易被忽略的是：这个缩进问题不会报错，但会显著降低代码可读性，且后续 diff 容易污染提交记录——每次包裹完顺手一按，成本几乎为零。
