应关闭“Comment at first column”选项：在PhpStorm中进入Settings/Preferences→Editor→Code Style→PHP→Wrapping and Braces，取消勾选该选项，使//注释自动对齐当前代码缩进；同时需关闭Detect and use existing file indents及EditorConfig支持，避免其覆盖注释缩进规则。
注释缩进失效，先关掉 Comment at first column
PhpStorm 默认把 // 注释强行塞到行首，哪怕你在 4 层缩进的 if 块里按 Ctrl + /，也会变成：
if ($x) {
// return true;
}
这不是 bug，是 Comment at first column 开关开着。解决路径很固定：
- 进入
Settings/Preferences → Editor → Code Style → PHP → Wrapping and Braces - 取消勾选
Comment at first column - 改完立刻生效，无需重启
注意：这个选项在 JS、Python 等语言设置里也叫同样名字，只是路径中语言名不同（如 JavaScript → Wrapping and Braces）。
快捷键注释还是不缩进？检查 EditorConfig 和缩进检测
即使关了 Comment at first column，Ctrl + / 仍可能不缩进，两个干扰项最常见：
立即学习“PHP免费学习笔记（深入）”；
-
Detect and use existing file indents for editing：在Editor → Code Style → General里，必须取消勾选，否则 PhpStorm 会“尊重”文件里混乱的旧缩进，跳过你的注释规则 -
Enable EditorConfig support：如果项目根目录有.editorconfig，它里面的indent_style和indent_size会直接覆盖 PhpStorm 设置，包括注释缩进逻辑
右下角显示的 Spaces: 4 只反映当前文件缩进字符类型，和注释是否对齐无关。
新建文件头部注释不见了，检查 PHP File Header 模板
新建 PHP 文件时没自动出现作者、日期等头部注释，不是 Live Templates 的问题，而是模板位置错了：
- 路径是：
Settings → Editor → File and Code Templates → Files → PHP File Header - 里面可用变量只有
${USER}、${DATE}、${TIME}、${NAME}，旧写法如$nowTime$会被原样输出 - 改完必须点
Apply，只点OK不生效
别去 Live Templates 里加 /** —— 那只影响手动输入后按 Tab 的场景，对新建文件完全无效。
函数上方 /** 回车没生成参数，确认 Live Template 启用状态
输入 /** 后按 Enter，结果只有空模板，没有 @param 或 @return，大概率是 Live Template 没配对或没启用：
- 进
Settings → Editor → Live Templates → PHP，找phpdoc模板 - 确保
Expand with设为Enter或Tab - 检查
Applicable in是否包含PHP: function declaration - 模板正文里用
${PARAM_DOC}、${TYPE_HINT}等变量，不是$PARAM_DOC$
如果函数参数是 ...$args 或没类型声明，@param 会退化成 mixed —— 这是类型推断失败，不是模板问题。
恢复注释设置最易被忽略的点：三个层级（文件新建、快捷键注释、文档注释）互不干扰，改错地方就白忙；.editorconfig 和 Detect and use existing file indents 是静默覆盖者，不排查就永远“以为设对了”。
