VSCode末尾换行格式化失效怎么解决？结尾空行规范教学-VSCode-PHP中文网

VSCode末尾换行失效的根本原因是files.insertFinalNewline未启用，因VSCode默认不保证EOF换行；必须同时设"files.insertFinalNewline": true（兜底补一个\n）和"files.trimFinalNewlines": true（压缩多余\n），且需排除.editorconfig或工作区设置覆盖，验证须用tail -c1 file.js | xxd确认末字节为0a。

vscode末尾换行格式化失效怎么解决？结尾空行规范教学

VSCode 末尾换行格式化失效，不是格式化工具“坏了”，而是 files.insertFinalNewline、files.trimFinalNewlines 和格式化器（如 Prettier）三者没对齐——尤其当 files.trimFinalNewlines 设为 true 却没配 files.insertFinalNewline 时，文件末尾永远补不上换行符。

为什么保存后文件末尾还是没换行？

根本原因：VSCode 原生不保证末尾有换行符，editor.formatOnSave 不管这事，它只调用格式化器；而格式化器是否加换行，取决于它自己的配置（比如 Prettier v3+ 默认加，但 ESLint 的 final-newline 只报错不自动修）。

files.insertFinalNewline: true 是唯一能“兜底补换行”的开关，但它只在保存时触发，且仅当末尾没有换行符时才加一个
files.trimFinalNewlines: true 会把末尾多个 \n 压成一个，但如果本来就没有，它不会补——反而可能和 insertFinalNewline 冲突（先删后补？不，VSCode 执行顺序是 trim → insert，所以设 true + true 是安全的）
如果项目根目录有 .editorconfig，且含 insert_final_newline = true，VSCode 的 files.insertFinalNewline 会被静默覆盖，设置界面里开着也无效
右下角状态栏显示 LF 或 CRLF ≠ 文件末尾有换行符——它只表示当前文件换行符类型，得用 tail -c1 file.js | xxd 看最后一字节是不是 0a

怎么让 Prettier 和 VSCode 换行行为一致？

别只改 prettier.endOfLine。Prettier 的 "lf" 配置只是告诉它“格式化时用 LF”，但 VSCode 保存时仍按 files.eol 写入，Git 还可能在中间转一次 CRLF。

必须同步配三项："files.eol": "\n"、"files.preferredLineEnding": "lf"、git config --global core.autocrlf false
项目根加 .gitattributes，内容只写：* text=auto eol=lf，再执行 git add --renormalize .
Prettier 配置里保留 "endOfLine": "lf"，但它的优先级低于 VSCode 的 files.eol —— 所以 VSCode 设置必须先对齐
如果用了 eslint.format.enable: true，ESLint 会作为格式化器介入保存流程，此时它的 final-newline 规则才起作用；否则它只在保存后报错，不自动修复

结尾空行 vs 行尾空格：两个设置别混用

files.trimTrailingWhitespace 和 files.trimFinalNewlines 解决的是完全不同的问题，但常被一起开——这是对的，但得清楚各自干啥。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

files.trimTrailingWhitespace: true → 删每行末尾的空格/制表符，不影响空行
files.trimFinalNewlines: true → 删文件末尾所有连续空行（哪怕 10 个，只剩最后一个非空行）
files.insertFinalNewline: true → 在最后一个非空行后面补一个 \n，不管前面有没有空行
三者共存时顺序是：trim whitespace → trim final newlines → insert final newline。所以即使你手动留了空行，保存后也会变成“内容 + 一个换行符”，干净利落