VSCode 新建文件默认用 LF 需手动设置 "files.eol": "\n" 并重启窗口,否则 Windows 下新建文件为 CRLF,引发 Git 脏提交和 Prettier 报错;该设置仅影响未指定换行符的新文件,且可能被工作区设置、EditorConfig 或 Git 配置覆盖。

VSCode 新建文件默认用 LF,必须手动设 "files.eol": "
",否则 Windows 下新建文件几乎必为 CRLF——这不是 bug,是设计行为,但会直接引发 Git 脏提交和 Prettier 报错。
怎么让新文件一创建就是 LF
VSCode 不会自动继承系统偏好来统一换行符,它按平台默认:Windows 用
,macOS/Linux 用
。想跨平台一致,就得强制覆盖。
- 打开设置(
Ctrl+,或Cmd+,),搜files.eol - 点击 Edit in settings.json,添加或修改这一行:
"files.eol": " "(注意:是带英文双引号的字符串" ",不是文字“LF”) - 保存后,**重启 VSCode 窗口**(
Ctrl+Shift+P→ Developer: Reload Window),否则新文件仍可能沿用旧行为 - 这个设置只影响“未指定换行符”的新文件,比如新建一个空
.js、.py文件;已存在的文件不会被自动转换
为什么改了 settings.json 还是 CRLF
常见原因不是配置写错了,而是被更高优先级的设置覆盖了:
- 项目根目录存在
.vscode/settings.json,里面写了"files.eol": " "(工作区设置 > 用户设置) - 你打开了多根工作区(
.code-workspace),其配置里显式设了files.eol - 装了 EditorConfig 插件,且项目有
.editorconfig,其中end_of_line = crlf会强行接管 - 验证方式:按
Ctrl+Shift+P输入 Preferences: Open Settings (JSON),确认看到的是你编辑的那个 JSON;再看右下角状态栏显示——如果新建文件显示 CRLF,说明上面某一层生效了
想临时切换单个文件的换行符
这是最常用、最即时的操作,不依赖任何配置:
- 打开任意文本文件,右下角状态栏会显示
CRLF或LF - 点击它 → 选
LF(或CRLF)→ 编辑器立刻按新格式重绘所有换行,无需保存就可见效果 - 但必须手动
Ctrl+S才真正写入磁盘;否则关掉再打开,还是原格式 - 这个操作只作用于当前文件,关掉再开也不会“记住”,适合救急或调试单个脚本
- 大文件(>50MB)点一下可能没反应——VSCode 会跳过处理,避免卡死
Git 和 VSCode 必须配合才真正稳
只改 VSCode 设置,解决不了协作场景的根本问题。Git 会在提交/检出时偷偷改换行符,导致本地文件和暂存区不一致:
- 在项目根目录加
.gitattributes,内容写:* text=auto eol=lf - 全局关掉 Git 自动转换:
git config --global core.autocrlf false(Windows 上若确定全用 LF) - 执行
git add --renormalize .强制重写索引,消除历史换行差异 - 注意:
eol=lf不影响 VSCode 编辑行为,只是确保 Git 提交时统一为 LF;VSCode 仍要设好files.eol,否则新文件一创建就是 CRLF,下次git add又触发 warning
真正麻烦的不是“怎么设”,而是“哪一层在起作用”——用户设置、工作区设置、EditorConfig、Git 配置,四层叠加,任意一层写错都会让 LF 变回 CRLF。建议先关掉所有插件,用最小配置验证,再逐个打开排查。


















