解决代码提交时的换行符问题

换行符不统一引发的麻烦

你在公司写代码，同事用的是 Windows，你用的是 macOS，结果一提交代码，Git 就提示一堆文件被修改。点开一看，几乎每一行都标红，但逻辑没动过——这大概率是换行符在作怪。

不同操作系统对换行的处理方式不一样：Windows 用的是 CRLF（\r\n），而 macOS 和 Linux 用的是 LF（\n）。当你在一个系统上编辑文件，另一个系统拉取时，Git 会认为整份文件的换行都被改动了，导致无意义的 diff 和合并冲突。

Git 如何处理换行符

Git 提供了自动转换机制，通过 core.autocrlf 配置项来适配不同平台。这个设置不是“一劳永逸”，得根据你当前使用的系统来调整。

Windows 用户建议设置：

git config --global core.autocrlf true

这样 Git 在提交时会把 LF 转成 CRLF，拉取时再转回 LF，保证仓库里存的是 LF。

macOS 和 Linux 用户应该设为：

git config --global core.autocrlf input

这样提交时自动转成 LF，但本地不转换，避免文件被意外改动。

项目级统一方案：.gitattributes

靠个人配置容易出错，最好的办法是在项目根目录加一个 .gitattributes 文件，强制规范换行行为。

比如加入这行：

* text=auto

Git 会自动判断文本文件并统一处理换行符。如果你想更明确，可以指定特定类型：

*.py text eol=lf
*.js text eol=lf
*.bat text eol=crlf

这样 Python 和 JS 文件强制使用 LF，Windows 批处理脚本则用 CRLF，团队协作时就不会因为换行符吵起来了。

已有文件被污染怎么办

如果项目已经因为换行符混乱产生大量差异，可以强制重新规范化：

git rm --cached -r .
git reset --hard

执行后 Git 会根据当前配置和 .gitattributes 重新应用换行规则。注意：这会重置工作区未提交的改动，操作前确保已备份或提交。

编辑器也得配合

有些编辑器默认按系统习惯保存换行符，比如 VS Code 右下角会显示 CRLF 或 LF。点击它就能切换，建议项目中统一设为 LF，尤其是跨平台协作时。

也可以在 VS Code 的设置里添加：

{
  "files.eol": "\n"
}

让所有文件默认用 LF 换行，减少人为差异。