VSCode换行符需统一为LF以避免协作问题：当前文件可点击右下角状态栏即时切换；新建文件设"files.eol": "\n"；项目级统一需配.gitattributes（* text=auto eol=lf）+ VSCode设"files.preferredLineEnding": "lf"。
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 尊重它。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
在项目根目录加一个
.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
，结果一构建就崩。
