如何配置.gitattributes解决Windows下LF文件误判为脏文件问题

问题分析 #

当前你的.gitattributes已配置基础的文本/二进制文件规则，但Windows环境下使用Texmaker保存.tex文件时，编辑器会强制将行尾转为LF，导致Git误判文件为已修改（即便内容无变化）。核心矛盾在于Git的行尾转换逻辑与编辑器的强制行尾设置冲突，且需要兼容不同编辑器的行尾偏好，无需修改用户本地Git配置。

解决方案 #

通过优化.gitattributes规则并规范化仓库文件行尾，实现仓库级的通用解决：

1. 更新.gitattributes配置 #

在现有内容基础上，为.tex文件添加明确的行尾处理规则，覆盖本地Git配置的影响：

* text=auto

*.pdf binary
*.xlsx binary
*.png binary
*.jpg binary

# 明确指定.tex文件为文本文件，自动适配系统行尾
*.tex text eol=auto

• text：标记.tex为文本文件，参与Git的行尾转换逻辑
• eol=auto：让Git根据用户操作系统自动处理检出时的行尾（Windows转CRLF，Unix/Linux转LF），提交时统一转为LF存入索引

2. 规范化仓库中的文件行尾 #

执行以下命令，重新规范化所有文本文件的行尾，确保索引中统一为LF格式：

# 重新规范化所有文件的行尾
git add --renormalize .
# 提交规范化操作
git commit -m "Normalize line endings for all text files"

原理说明 #

• 优化后的.gitattributes规则优先级高于用户本地的core.autocrlf设置，确保所有用户遵循统一的行尾处理逻辑
• 当Texmaker将Windows工作区的.tex文件行尾转为LF时，Git会对比规范化后的内容（索引中的LF），由于工作区LF转换后与索引一致，不会被标记为脏文件
• 兼容使用强制CRLF编辑器的用户：Windows环境下检出时Git仍会自动转CRLF，不影响这类用户的正常编辑

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