VSCode 要真正符合 POSIX 行尾要求，必须同时启用 "files.insertFinalNewline": true、"files.trimFinalNewlines": true 和 "files.eol": "\n"，并配合 editor.formatOnSave 与格式化工具的 endOfLine: "lf" 配置，缺一不可。
VSCode 默认不强制文件末尾换行，但 POSIX 标准要求文本文件最后一行必须以换行符（
）结尾；启用该行为需手动配置，且仅靠 files.insertFinalNewline 不够，必须配合 files.trimFinalNewlines 和保存时机控制。
为什么 files.insertFinalNewline 单独开启还不够
这个设置只在「保存时」检查末尾是否缺失换行符并自动补上，但它不处理已有内容末尾带多余空白或混合换行符（如
）的情况。更关键的是：如果文件原本末尾有空行（即已有
），它不会去重；如果用户手动删掉了最后一行的换行符，下次保存又没改动其他内容，VSCode 可能跳过格式化逻辑，导致遗漏。
-
files.insertFinalNewline是“尽力而为”，不是“强制保障” - 它不触发保存前的完整行尾标准化（比如统一转为
- 和 Prettier、ESLint 等工具共存时，可能因执行顺序冲突导致最终结果不符合 POSIX
真正符合 POSIX 的最小可靠配置组合
必须同时启用三项，并确保它们在保存时协同生效：
- 设置
"files.insertFinalNewline": true—— 补最后一行换行符 - 设置
"files.trimFinalNewlines": true—— 先清理末尾所有空行，避免多加换行 - 设置
"files.eol": " "—— 强制统一行结束符为 LF（POSIX 要求），而非系统默认（Windows 下默认是 - （可选但推荐）启用
"editor.formatOnSave": true，并确认你使用的 formatter（如 Prettier）配置了"endOfLine": "lf"
这些配置应写入工作区 .vscode/settings.json，而非用户全局设置，避免影响非 POSIX 场景（如某些 Windows-only 批处理）。
验证是否生效的快速方法
改完配置后，用二进制方式确认文件结尾是否真的只有单个
：
- 终端执行：
xxd yourfile.js | tail -n 1，最后一行应显示类似000003b0: 6e0a n.（即十六进制0a，对应 - 或者用
cat -A yourfile.js，末尾应只显示一个$，而不是多个$$ - 编辑器右下角状态栏要显示
CRLF或LF—— 必须是LF，且点击后切换选项里不能灰色不可选
注意：如果文件是 Git 仓库中已提交的老文件，Git 可能缓存了旧的行尾，需要 git add --renormalize . 重新应用 .gitattributes 规则。
容易被忽略的边界情况
空文件、单行无换行、BOM 头文件、符号链接指向的文件，这四类 VSCode 不一定按预期处理：
- 空文件：即使启用了
insertFinalNewline，保存后仍是空字节（0-length），不自动写入 - 单行无换行：比如内容为
hello（无任何换行符），保存后会变成hello，正确 - BOM 文件（如 UTF-8 with BOM）：VSCode 可能优先尊重 BOM 而忽略
files.eol，建议关闭 BOM（设"files.autoGuessEncoding": false并手动保存为 UTF-8 without BOM） - 通过 symlink 打开的文件：VSCode 有时读取的是目标路径的设置，而非 symlink 所在目录的
.vscode/settings.json，此时需在目标路径下也配好
POSIX 合规不是开关一开就万事大吉的事，它依赖配置链的每个环节都咬合到位，尤其是保存动作发生时的执行顺序和文件元信息状态。
