未修改代码却在Ctrl+S后Git工具显示全行变更的问题咨询

环境与场景 #

• 使用IDE：Eclipse、VS Code
• 使用Git工具：SourceTree、VS Code
• 操作情况：未对代码做任何修改，按下Ctrl+S保存后，SourceTree显示所有行均被标记为编辑；实际仅有的内容差异为：
  原代码行：

  import org.apache.poi.ss.usermodel.Cell;␍import org.apache.poi.ss.usermodel.CellType;
  

  保存后代码行：

  import org.apache.poi.ss.usermodel.Cell; import org.apache.poi.ss.usermodel.CellType;
  

• 已确认：未开启「保存时格式化代码」相关设置
• 疑问：这是当前Git版本的Bug吗？期望仅修改指定行后再推送到Git分支。

解答 #

这不是Git的Bug，核心原因是编辑器自动转换换行符格式导致的：

1. 原文件使用单独的CR（␍，ASCII 0x0D）作为换行符，保存后编辑器将其替换为「空格分隔」的格式（本质是换行符被转换成空格，或是编辑器自动统一了换行符标准），Git对文本文件的换行符变化会识别为整行修改，进而显示全文件变更。
2. 编辑器隐形设置影响：即使未开启「保存时格式化」，VS Code、Eclipse等工具默认带有「文件编码与换行符自动同步」功能，打开非系统默认换行格式的文件时，会自动转换为系统适配的格式，保存时直接覆盖原文件的换行符。

解决办法 #

• 统一项目换行符规范：在项目根目录创建.gitattributes文件，写入如下内容（根据项目需求选择换行符标准）：

  * text=auto eol=lf  # 统一使用LF换行符
  # 或
  * text=auto eol=crlf # 统一使用CRLF换行符
  

  该文件会强制Git按照指定规则处理换行符，避免跨编辑器的格式差异。
• 关闭编辑器自动换行转换：
  • VS Code：打开设置（Ctrl+,），搜索files.eol，设置为与原文件一致的换行符（比如\r），同时关闭files.autoGuessEncoding选项。
  • Eclipse：依次进入「Window > Preferences > General > Workspace」，将「New text file line delimiter」设为原文件的换行格式，取消勾选「Convert line endings on save」。
• 单文件临时修复：开启编辑器的「显示所有字符」功能，手动还原换行符后再保存：
  • VS Code：按Ctrl+Shift+P，搜索「Toggle Render Whitespace」开启显示；
  • Eclipse：点击工具栏的「Show Whitespace Characters」按钮开启显示。

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