VSCode仅启用files.insertFinalNewline不足以满足POSIX要求，必须同时配置files.insertFinalNewline、files.trimFinalNewlines和files.eol: "\n"，因其仅补漏不清理、不处理混合换行符、对空文件无效，且无法确保换行符为LF。
VSCode 默认不保证文件末尾有换行符，只开 files.insertFinalNewline 不足以满足 POSIX 要求；必须同时启用 files.insertFinalNewline、files.trimFinalNewlines 和 files.eol 三项设置，并确保它们在保存时协同生效。
为什么只开 files.insertFinalNewline 不行
这个设置只是“补漏”：仅当文件末尾没有换行符时，保存时加一个；但它不处理已有多个换行、混合 \r\n 和 \n、或末尾带空格/制表符的情况。更关键的是：
- 如果文件原本末尾有两个
\n，它不会删掉多余的那个 - 如果用户手动删掉了最后一行的换行符，但后续保存没改其他内容，VSCode 可能跳过格式化逻辑，导致遗漏
- 它对 0 字节空文件完全无效——保存后仍是空文件，不会自动插入
\n
files.insertFinalNewline 和 files.trimFinalNewlines 必须一起开
二者组合才是 POSIX 合规的最小可靠行为：先删光末尾所有换行（包括空行），再强制补一个 \n。效果是结尾严格只有一个换行符。
-
"files.trimFinalNewlines": true→ 删除末尾所有连续的换行符（不管几个） -
"files.insertFinalNewline": true→ 在删完之后，确保末尾存在且仅存在一个换行符 - 顺序固定：VSCode 内部执行是先 trim、再 insert，不会出现“删完又加两个”的情况
别忘了 files.eol 控制换行符类型
POSIX 要求的是 LF（\n），不是 CRLF（\r\n）。Windows 用户尤其容易忽略这点：即使末尾有换行，若它是 \r\n，仍不符合 POSIX。
- 必须显式设为
"files.eol": "\n"，不能依赖系统默认 - 该设置影响所有保存行为，包括格式化工具输出（前提是格式化器不强行覆盖）
- 配合 Prettier 时，还需确认其配置含
"endOfLine": "lf"，否则可能被绕过
验证是否真生效的三个硬指标
改完配置后，别只看右下角状态栏显示 LF 就以为 OK——它可能只是“显示为 LF”，实际文件结尾未必合规。
- 用
xxd yourfile.js | tail -n 1查十六进制：最后一行应类似000003b0: 6e0a n.（0a是\n的 hex） - 用
cat -A yourfile.js看：末尾应只显示一个$，而不是$$或^M$ - Git 仓库中老文件需运行
git add --renormalize .，否则缓存的 CRLF 会继续干扰
空文件、BOM 头文件、符号链接指向的文件，这三类 VSCode 不会按常规逻辑插入换行符——它不报错，也不提示，但就是不生效。团队协作中 CI 报 No newline at end of file 却查不出原因，往往卡在这儿。
