跨Windows与Linux配置Git避免换行符虚假变更

问题本质 #

你遇到的虚假变更，核心原因是Git对文本文件的换行符处理规则不明确：Windows端提交了带CRLF（^M）的文件到仓库，Linux端检出后，Git默认将CRLF视为需要转换为LF，从而标记文件为修改。即便配置了.gitattributes和.editorconfig，若规则未覆盖所有文件类型或与本地配置冲突，仍会触发这类问题。

分步解决方案 #

1. 用.gitattributes强制统一规则（优先级最高）

.gitattributes的规则会覆盖全局/本地Git配置，必须明确指定不同文件类型的换行处理逻辑，避免Git自动推断。示例配置如下：

# Windows专属工程文件：检出时用CRLF，提交时转为LF存储
*.sln text eol=crlf
*.csproj text eol=crlf
*.vcxproj text eol=crlf

# 跨平台代码文件：统一使用LF（提交/检出均为LF）
*.cs text eol=lf
*.py text eol=lf
*.js text eol=lf

# 二进制文件跳过换行处理，避免误判为文本文件
*.png binary
*.jpg binary
*.dll binary

2. 修正本地Git配置

确保Windows和Linux端的配置不干扰.gitattributes的规则：

• Windows端：执行命令锁定配置

  git config --global core.autocrlf false
  git config --global core.eol native
  

• Linux端：重置为默认配置（若之前有修改）

  git config --global core.autocrlf false
  git config --global core.eol native
  

3. 归一化仓库中现有文件的换行符

执行以下命令，让Git根据新的.gitattributes规则重新处理所有文件，消除历史遗留的换行符差异：

# 重新归一化所有文件的换行符
git add --renormalize .
# 提交归一化变更
git commit -m "Normalize line endings per .gitattributes rules"

4. 同步.editorconfig配置

确保编辑器保存文件时使用符合规则的换行符，从源头避免问题：

root = true

[*]
end_of_line = lf
charset = utf-8
indent_style = space
indent_size = 4

# 匹配Windows工程文件的CRLF要求
[*.sln]
end_of_line = crlf

[*.csproj]
end_of_line = crlf

关键注意点 #

• 不要依赖Git的自动推断逻辑，必须通过.gitattributes明确所有文本文件的换行规则；
• 归一化操作前，务必提交或暂存所有非换行符相关的变更，避免数据丢失；
• 确保团队所有成员都同步上述配置，避免跨平台协作时重复出现问题。

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