必须开启“Ensure blank line at the end of file”，因PSR-12硬性要求文件末尾有且仅有一个换行符，否则phpcs报EOF错误；该选项位于Settings → Editor → General，需勾选并点击Apply，同时关闭Strip trailing spaces on Save以防冲突。
“Ensure blank line at the end of file”必须开启，否则PSR-12直接不通过
PSR-12 明确要求：每个 PHP 文件末尾必须有且仅有一个换行符（\n），否则 phpcs 会报 EOF blank line 错误，Git diff 也会把最后一行标为“missing newline”——这不是风格问题，是规范硬性门槛。
这个开关不在 Code Style 里，而在通用编辑行为设置中：
- 打开
Settings > Editor > General - 勾选
Ensure blank line at the end of file - 务必取消勾选
Strip trailing spaces on Save（如果同时启用，它可能在补换行前删掉末尾空格，导致补行失败） - 点
Apply—— 不点这一步，设置完全不生效
该设置只对「保存动作」起效：新文件创建即带空行；已有文件需手动保存一次才会补上。
批量修复老项目：用 PSR-12 Code Style + Reformat Code
单靠保存补空行太慢，尤其面对上百个历史 PHP 文件。真正可控的批量方案是让 PhpStorm 按 PSR-12 规则重排整个项目：
立即学习“PHP免费学习笔记（深入）”；
- 进入
Settings > Editor > Code Style > PHP - 点击右下角
Set from… > Predefined style > PSR-12 - 展开
Blank lines→ 确认At end of file设为1 - 全选项目根目录 → 右键 →
Reformat Code（或Ctrl+Alt+L）
注意两个关键点：
- 若项目含
.editorconfig，检查其中是否写了insert_final_newline = false—— 这会覆盖 IDE 设置，必须删掉或改为true - 格式化前先
git add -N .或提交快照，因为该操作会修改所有文件末尾，diff 量极大
为什么 Ctrl+Alt+L 有时不补空行？常见失效场景
Ctrl+Alt+L 是触发 Code Style 重排的快捷键，但它是否补末尾空行，取决于当前上下文是否命中「文件级格式化」条件：
- 光标未选中文本，但停在
class或function关键字上 → PhpStorm 默认只格式化该结构体，不处理文件末尾 - 文件被识别为
Plain Text或Text（右下角状态栏显示不对）→ 格式化规则压根不加载，需右键 →Override File Type > PHP - 项目启用了外部工具如 PHP CS Fixer →
Ctrl+Alt+L实际调用的是外部命令，其配置（如.php-cs-fixer.php）决定是否加空行，和 IDE 设置无关
验证是否生效最简单的方法：在某 PHP 文件末尾手动删掉换行 → Ctrl+S → 看是否自动补回。如果没补，说明 Ensure blank line at the end of file 没开或没 Apply。
和行尾空格清理、空行压缩不是一回事，别混着配
很多人以为开了 Strip trailing spaces on Save 就等于“清理末尾”，其实它只删行尾空白字符，和文件末尾换行符（\n）完全无关；同样，Keep maximum blank lines = 1 控制的是中间空行数，不影响结尾。
三者必须独立配置，且作用时机不同：
-
Ensure blank line at the end of file：保存时检查并补一个\n（仅限文件末尾） -
Strip trailing spaces on Save：保存时删每行末尾空格/Tab（可选 All lines 或 Modified lines only） -
Keep maximum blank lines = 1：格式化时（Ctrl+Alt+L或 On Save 启用 Run code formatter）压缩连续空行
最容易忽略的是：PHP、JS、HTML 的 Code Style 设置彼此隔离，PHP 里设了 At end of file = 1，JS 文件照样不会补——得去 Code Style > JavaScript 单独设。
