Git 将文件末尾无换行视为修改，因默认以 LF 为行结束符；VSCode 需启用 files.insertFinalNewline 并禁用 trimFinalNewlines，配合 .gitattributes 统一换行策略。
为什么 Git 会把文件末尾换行当成修改？
Git 默认将 \n（LF）作为行结束符，而 Windows 系统下某些编辑器可能不写末尾换行，或写成 \r\n（CRLF）。当文件末尾缺失换行符时，Git 会在 git diff 中标出 “no newline at end of file”，且该差异会被纳入提交——哪怕你只改了一行内容，它也会多出一行“删除空行”的假变更。
VSCode 如何强制保存时添加末尾换行？
VSCode 的 files.insertFinalNewline 是关键开关，但它必须配合 files.trimFinalNewlines 和文件类型设置才可靠生效：
-
"files.insertFinalNewline": true—— 保存时自动在文件末尾插入一个\n -
"files.trimFinalNewlines": false—— 避免保存时又把它删掉（二者冲突会导致无效） - 若只想对特定语言生效（如只对
.js、.py），可在对应语言的settings.json块中覆盖，例如："[javascript]": { "files.insertFinalNewline": true }
为什么设置了 still 不生效？常见干扰项
VSCode 的换行行为受多层配置叠加影响，优先级从高到低是：文件夹级 .vscode/settings.json > 用户级 settings.json > 扩展默认值。容易踩的坑包括：
- 某项目根目录存在
.vscode/settings.json，其中"files.insertFinalNewline": false覆盖了全局设置 - 安装了 Prettier 或 EditorConfig 插件，它们各自控制换行逻辑——Prettier 的
endOfLine选项（"lf"/"crlf"）会覆盖 VSCode 原生行为 - 文件当前编码不是 UTF-8（如 UTF-8 with BOM），VSCode 可能拒绝插入换行，需手动转为纯 UTF-8
Git 层面同步统一换行策略
仅靠 VSCode 设置不能解决团队协作中的换行混乱。必须配合 Git 的 .gitattributes 文件：
- 在仓库根目录新建
.gitattributes，写入：* text=auto eol=lf
- 这会让 Git 自动将所有文本文件（除明确标记 binary 的）转为 LF 换行，并忽略工作区 CRLF
- 执行
git add --renormalize .强制重写索引，让历史差异归零
注意：eol=lf 不会改变你本地编辑器的行为，只是确保 Git 提交和检出时统一用 LF。VSCode 仍要设好 files.insertFinalNewline，否则新文件一创建就缺末尾换行，下次 git add 时又会触发警告。
