<p>VSCode换行符需统一为LF以避免协作问题：当前文件可点击右下角状态栏即时切换；新建文件设"files.eol": "\n"；项目级统一需配.gitattributes（* text=auto eol=lf）+ VSCode设"files.preferredLineEnding": "lf"。</p>
VSCode 默认会按系统自动设换行符，但团队协作时混用 CRLF 和 LF 会导致 Git 脏提交、diff 异常甚至脚本执行失败——必须手动统一。
怎么在当前文件里临时切换换行符
这是最常用、最即时的操作。打开一个文件后，右下角状态栏会显示当前换行符类型（如 CRLF 或 LF），点击它就能弹出切换菜单。
- 点一次弹出选项，选
LF或CRLF即刻生效，不保存也会在编辑器里体现 - 改完记得手动保存（
Ctrl+S/Cmd+S），否则下次打开还是原格式 - 这个操作只影响当前文件，关掉再开也不会“记住”，适合救急或单文件调试
怎么让新文件默认用 LF（推荐团队统一用这个）
VSCode 的 files.eol 设置决定新建文件的默认换行符，Linux/macOS 默认是 \n（即 LF），Windows 默认是 \r\n（即 CRLF），但可以强制覆盖。
- 打开设置（
Ctrl+,），搜files.eol - 把值设为
"\n"（注意是字符串，带英文双引号） - 这个设置写进用户级配置，对所有新创建的文件生效，但不影响已存在的文件
- 如果项目里已有大量
CRLF文件，别只改这个——得配合下面的全局策略
怎么让整个项目自动转成 LF 并持久化（Git + VSCode 联动）
光靠 VSCode 设置不够，Git 会自己转换行尾，容易和编辑器打架。真正靠谱的做法是：用 .gitattributes 锁定规则，再让 VSCode 尊重它。
- 在项目根目录加一个
.gitattributes文件，内容写：* text=auto eol=lf
- 然后在 VSCode 设置里打开
files.autoSave，并设files.enableTrash为false（避免误删） - 关键一步：在 VSCode 设置里把
files.preferredLineEnding设为lf（不是"\n"，是字符串lf）——这个值会优先读取.gitattributes - 已有文件要批量转，运行：
git add --renormalize .，再git commit，Git 会按规则重写索引中的换行符
为什么改了设置还是看到 CRLF？常见踩坑点
不是设置没生效，而是多个机制在叠加影响，优先级容易搞反。
-
.gitattributes比 VSCode 用户设置优先级高；如果它写了eol=crlf，VSCode 就会强制切回CRLF - 某些语言扩展（比如 Python 插件）会读取
editor.detectIndentation，间接影响换行行为，建议关掉："editor.detectIndentation": false - 用
file://打开本地文件时，VSCode 可能忽略工作区设置，必须用“通过文件夹打开”方式加载项目 - 检查真实换行符别只看右下角——用命令行
file -i filename或 VSCode 安装Hex Editor扩展直查看二进制
换行符问题从来不是“设个选项就完事”，它卡在编辑器、Git、操作系统、语言工具链四层中间。最容易被忽略的是：你改了 VSCode，但队友没改 Git 配置，或者 CI 机器上 core.autocrlf 是 true，结果一构建就崩。
