关闭“Comment at first column”即可解决行注释缩进不对齐问题：该选项位于Settings/Preferences → Editor → Code Style → PHP → Wrapping and Braces，取消勾选后，//注释将严格对齐当前代码缩进层级，且仅影响行注释，不影响块注释或PHPDoc。
包裹代码时缩进不自动对齐？关掉 Comment at first column
PhpStorm 默认把 // 注释硬塞到行首，哪怕你光标在 if 块内部按 Ctrl + /，结果也是：
if ($x) {
// return true;
}这不是 bug，是 Comment at first column 开着。它位于 Settings/Preferences → Editor → Code Style → PHP → Wrapping and Braces，取消勾选即可。改完立刻生效：再输入 // 或用快捷键，注释会严格对齐当前代码缩进层级。
注意：Comment at first column 只影响行注释（//），不影响 /* */ 块注释或 PHPDoc；它也不控制 try-catch 包裹行为——那是另一套模板逻辑。
Ctrl + Alt + T 包裹 try-catch 后缩进错乱？别依赖自动补全
用 Ctrl + Alt + T 调出 Live Template 插入 try{ $SELECTION$ }catch(\Throwable $e) { error_log($e->getMessage()); throw $e; } 后，缩进不会自动适配上下文。常见现象是：
立即学习“PHP免费学习笔记（深入）”；
- 原代码缩进为 4 空格，包裹后
try块顶格，catch块却缩进 2 空格 - 选中多行代码包裹后，
try和catch的花括号没对齐当前作用域
根本原因：Live Template 是纯文本插入，不触发格式化引擎。解决方法只有两个：
- 插入后立刻按
Ctrl + Alt + L（确保未选中文本，否则只格式化选区） - 或者提前配置好
Settings → Editor → General → On Save → Run code formatter，保存时自动修正
别指望 Ctrl + Shift + Enter 补全 throw $e; 时顺带修缩进——它只补语句，不重排结构。
为什么 Convert Indents 对包裹后的代码无效？因为它不处理模板插入内容
有人试过右下角点 Tab: 4 → Convert Indents → To Spaces，发现包裹后的 try 块还是缩进异常。这是因为：
-
Convert Indents只扫描已有空白字符并批量替换，不识别语法结构 - Live Template 插入的文本自带原始空格（比如模板里写的是两个空格开头），
Convert Indents不会“智能重算”该缩进是否合理 - 它对新插入的模板内容完全无感，只作用于文件已存在的字符
真正有效的做法是：模板里就写对缩进。例如把模板改成：
try {
$SELECTION$
} catch (\Throwable $e) {
error_log($e->getMessage());
throw $e;
}这样插入后，只要你的 Code Style → PHP → Tabs and Indents 中 Indent 设为 4、且 Use tab character 已关闭，就能和上下文自然对齐。
混用 Tab 和空格时包裹操作更危险
如果当前文件缩进混用（状态栏显示 mixed），Ctrl + Alt + T 插入的 try-catch 模板会继承光标所在行的“视觉缩进”，但实际字符可能是 Tab+空格组合。后果包括：
- Git diff 显示大量无关空白变更
- PSR-12 格式化直接降级为“安全模式”，跳过换行和括号对齐
- 团队协作时其他人格式化后，你的
try块突然多出两行空行或错位
预防动作必须做全：
- 关闭
Detect and use existing file indents for editing（在Editor → Code Style → General） - 禁用
Enable EditorConfig support，或确认项目根目录没有.editorconfig干扰 - 对现有文件执行
Edit → Convert Indents → To Spaces统一基数
包裹操作本身不会暴露缩进混乱，但会让问题在后续格式化或协作中集中爆发——这点最容易被忽略。
