如何查找Git仓库中引入CRLF换行符的相关提交记录

嘿，这个问题我之前帮团队排查过好几次，刚好可以给你一套实用的步骤，一步步搞定：

1. 先找出仓库中包含CRLF的文件 #

首先用git grep扫描整个仓库，找出所有包含回车符（\r）的文本文件：

git grep -I --name-only $'\r'

• -I 参数会忽略二进制文件，避免误报（比如图片、压缩包里的二进制数据可能刚好包含\r）
• --name-only 只输出有问题的文件名，让结果更简洁
• 如果命令返回了文件名，说明这些文件里确实存在已提交的CRLF换行符

2. 定位单个文件中CRLF首次引入的提交 #

针对找到的每个文件，我们可以用几种方法追踪到具体是哪个提交把CRLF加进去的：

方法一：用git log的补丁模式查看变更历史 #

这个方法能直观看到文件每一次变更的内容，方便找到CRLF出现的那一次提交：

git log --follow --patch -- <你的文件路径>

• --follow 会追踪文件的重命名（如果文件改过名字也能查到）
• --patch 会显示每次提交的具体变更内容，你可以在输出里找包含\r的行，对应的提交就是 culprit

方法二：用git blame快速定位行的提交者 #

如果已经知道文件里哪些行有CRLF，可以用git blame直接定位该行的提交信息：

git blame -p -- <你的文件路径> | grep -B2 -A2 '\r'

• -p 会显示更详细的blame信息，包括提交哈希、作者、提交时间
• grep -B2 -A2 '\r' 会过滤出包含\r的行，并显示前后2行的上下文，帮你快速找到对应的提交哈希

方法三：用git log的pickaxe功能精准查找 #

这个方法会自动找出所有**添加或删除过\r**的提交，效率很高：

git log -S$'\r' -- <你的文件路径>

-S 参数就是pickaxe，它会扫描所有提交，找出内容变更中包含目标字符串（这里是\r）的提交，直接列出这些提交的哈希和信息。

3. 查看提交者信息 #

拿到提交哈希后，用下面的命令就能看到对应的提交者：

git show <提交哈希>

输出里的Author字段就是提交者的名字和邮箱。如果只想快速看关键信息，可以用：

git log --pretty=format:"%h %an %ae %s" <提交哈希>

• %h：短提交哈希
• %an：作者姓名
• %ae：作者邮箱
• %s：提交说明

4. 给团队的预防建议 #

为了避免以后再出现这个问题，建议统一团队的Git配置：

• Windows用户设置：git config --global core.autocrlf true（检出时转CRLF，提交时转LF）
• Linux/macOS用户设置：git config --global core.autocrlf input（提交时转LF，检出时不转换）
• 更稳妥的方式是在仓库根目录添加.gitattributes文件，强制统一换行符处理：

  * text=auto
  

  这个配置会让Git自动识别文本文件，提交时统一转换为LF，检出时根据用户系统自动转换，从根源避免CRLF提交的问题。

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