关闭core.autocrlf后Git仍为部分文件添加CRLF换行的问题

问题 #

我在Windows环境下操作一个Git仓库，该仓库最初在Mac上创建，所有文件仅使用LF作为换行符。在另一台Mac上克隆该仓库时，所有文件的换行符仍为LF；但在Windows上克隆时，部分（而非全部）文件的换行符变为CRLF。已将core.autocrlf设置为false，通过git check-attr -a foo检查文件，未发现任何属性。

执行以下命令：

git rev-parse HEAD:foo   # 输出 "abc123...abc"
git cat-file -p "abc123...abc" | xxd

结果显示文件使用LF换行符（我在Windows上安装了xxd以减少工具引入的误差，此前发现git cat-file -p ... > temp.txt会将编码改为UTF-16）。

git status显示foo文件无变更，但将foo的换行符从CRLF转为LF后，git status则显示该文件有变更，尽管该文件本应始终使用LF换行符。

在Windows的WSL中执行git status时，所有带有多余CR的文件均显示为已变更；但Git Bash的结果与Windows一致。

请问这是什么原因？如何让Git停止修改我的换行符？

原因分析 #

• 换行符配置未完全锁定：虽然core.autocrlf设为false，但core.eol可能默认采用Windows的crlf设置，或者仓库缺少.gitattributes文件统一规则，导致Git对识别为文本的文件自动转换换行符。
• Git文本文件自动检测逻辑：Git会根据文件内容判断是否为文本文件，仅对文本文件应用换行符转换规则，二进制文件则保持LF原样——这就是只有部分文件被转换的核心原因。
• 跨环境配置差异：WSL中的Git使用Linux环境配置，不会自动处理换行符，因此能检测到CR的差异；而Windows原生Git和Git Bash共享的配置仍在悄悄处理换行符，导致git status显示无变更。

解决办法 #

1. 全局配置强制LF规则 #

在Windows终端或Git Bash中执行以下命令，彻底关闭自动转换并统一换行符为LF：

git config --global core.autocrlf false
git config --global core.eol lf
git config --global core.safecrlf warn

• core.eol=lf：指定所有文本文件的换行符为LF，覆盖系统默认
• core.safecrlf=warn：当Git检测到潜在换行符转换风险时发出警告，避免自动修改文件

2. 仓库内添加.gitattributes锁定规则 #

在仓库根目录创建.gitattributes文件，明确所有文件的换行符规则，确保所有克隆环境遵循统一设置：

# 所有文本文件统一使用LF
* text=auto eol=lf

# 二进制文件保持原样，不进行任何转换
*.png binary
*.jpg binary
*.exe binary

3. 修复已被转换的本地文件 #

对于已经变成CRLF的文件，执行以下命令将其统一转为LF，并提交到仓库：

# 重新标准化所有文件的换行符
git add --renormalize .
# 提交变更
git commit -m "Normalize line endings to LF for all files"

4. 验证配置是否生效 #

执行命令检查当前Git配置：

git config --list | grep core

确认core.autocrlf=false、core.eol=lf已正确配置。同时用git check-attr -a <文件名>验证.gitattributes的规则是否应用到目标文件上。

内容的提问来源于stack exchange，提问作者Dale Myers