VSCode 保存时自动在文件末尾添加换行符需启用 files.insertFinalNewline：设为 true 后，仅在保存时补全缺失的末尾换行符，不修改已有内容；注意工作区或语言专属设置可能覆盖该全局配置。
VSCode 保存时自动在文件末尾加换行符：靠 files.insertFinalNewline
VSCode 默认不保证文件末尾有换行符，但多数 Unix/Linux 工具（如 git、diff、cat）期望文本文件以换行符结尾；缺它会导致警告或行为异常（比如 git diff 显示 No newline at end of file）。
启用该行为只需设置一个布尔值：
- 打开设置（
Ctrl+,或Cmd+,），搜索insertFinalNewline - 勾选
Files: Insert Final Newline，或手动在settings.json中添加："files.insertFinalNewline": true
- 这个设置只在保存时生效——如果文件末尾没换行符，保存时自动补一个；已有则不动
- 注意：它不会影响已打开但未修改的文件，也不会在你敲回车时“预插入”，纯属保存钩子
为什么 files.insertFinalNewline 有时不生效？常见干扰项
设了却没效果，大概率不是插件冲突，而是被更细粒度的配置覆盖了：
-
files.insertFinalNewline是全局设置，但工作区（.vscode/settings.json）或语言专属设置（如"[javascript]": { "files.insertFinalNewline": false }）会优先级更高 - 检查当前文件的语言模式是否匹配——比如你编辑的是
foo.sh，但 VSCode 识别为Plain Text，而你的规则只写了"[shellscript]": {...}，那就不会触发 - 某些格式化扩展（如
Prettier）可能在保存时接管写入流程，绕过 VSCode 原生的换行符插入逻辑；此时需关掉editor.formatOnSave或让 Prettier 配置"endOfLine": "lf"并确保其自身支持末尾换行
和 files.trimTrailingWhitespace 要不要一起开？
建议一起开，两者互补且无冲突：
-
files.trimTrailingWhitespace清理行尾空格，避免脏 diff；files.insertFinalNewline确保文件结构合规——都是 Git 友好型设置 - 顺序上，VSCode 先 trim 尾部空白，再插入末尾换行符，所以不会出现“删掉空格后多出一个空行”的问题
- 但注意：如果某行只有空格，trim 后变成空行，而该空行又恰好是最后一行，那么
insertFinalNewline仍会在它后面再加一个换行符——结果是两个连续换行；这不是 bug，是设计如此
跨平台换行符：用 files.eol 控制 LF 还是 CRLF
末尾换行符的字符本身（\n 还是 \r\n）由另一个设置决定：
-
files.eol控制换行符类型，默认是"\n"（LF），适合 macOS/Linux；Windows 用户若需兼容旧工具，可设为"\r\n"（CRLF） - 这个设置和
files.insertFinalNewline独立运作：前者管“用什么字符换行”，后者管“要不要在末尾换行” - Git 用户注意：
core.autocrlf可能覆盖 VSCode 的files.eol行为；推荐统一设为core.autocrlf=true（Windows）或=input（macOS/Linux），再让 VSCode 保持"files.eol": "\n"
真正容易被忽略的是语言级覆盖和格式化扩展的介入时机——你以为设了就完事，其实可能被一行 "[json]": { "files.insertFinalNewline": false } 默默关掉了，或者 Prettier 在保存前已经把文件重写了。调的时候先关扩展、再查语言模式、最后看 settings.json 里有没有嵌套层级更高的配置。
