如何自动化重建Git提交历史以统一行尾格式？

方案一：重写全历史统一行尾（彻底解决） #

这种方式会修改所有提交的文件行尾，确保历史记录里的文件也统一使用LF，适合可以改写远程仓库历史的场景。

1. 备份仓库
   先做镜像备份，防止操作失误：

   git clone --mirror <你的仓库地址> repo-backup
   

2. 安装git filter-repo
   这是Git官方推荐的历史重写工具，比git filter-branch更可靠：

   • Ubuntu/Debian：sudo apt install git-filter-repo
   • macOS：brew install git-filter-repo

3. 克隆仓库并处理行尾

   # 克隆仓库到本地
   git clone <你的仓库地址> repo-fix
   cd repo-fix
   
   # 用filter-repo重写所有提交
   git filter-repo --blob-callback '
       import os
       # 只处理指定后缀的文件
       if blob.path.endswith((".c", ".cpp", ".h", ".hpp")):
           # 将CRLF替换为LF
           blob.data = blob.data.replace(b"\r\n", b"\n")
   ' --commit-callback '
       # 确保每个提交都包含.gitattributes（避免后续行尾再混乱）
       attr_content = b"*.c text eol=lf\n*.cpp text eol=lf\n*.h text eol=lf\n*.hpp text eol=lf\n"
       attr_path = ".gitattributes"
       if attr_path not in commit.tree:
           from gitfilterrepo import blobutil
           commit.tree[attr_path] = blobutil.BlobData(attr_content)
   '
   

4. 验证结果
   检查文件行尾是否统一：

   git ls-files --eol
   

   查看输出中目标文件的eol列应为lf。

5. 推送到远程
   注意：强制推送会覆盖远程历史，必须提前通知团队成员：

   git push --force origin main
   

   团队成员需要重新克隆仓库，或执行：

   git fetch origin && git reset --hard origin/main
   

方案二：仅修复当前分支（不修改历史） #

如果不能改写远程历史，可采用这种方式，只统一当前分支的文件行尾，历史记录保留原样：

1. 添加.gitattributes文件

   echo -e "*.c text eol=lf\n*.cpp text eol=lf\n*.h text eol=lf\n*.hpp text eol=lf" > .gitattributes
   git add .gitattributes
   git commit -m "Add .gitattributes to enforce LF line endings"
   

2. 批量转换行尾

   # 用dos2unix转换所有目标文件
   find . -type f \( -name "*.c" -o -name "*.cpp" -o -name "*.h" -o -name "*.hpp" \) -exec dos2unix {} +
   
   # 提交转换后的文件
   git add .
   git commit -m "Normalize line endings to LF for source files"
   

注意事项 #

• 方案一适合私有仓库或团队可以配合改写历史的场景，能彻底解决行尾不一致问题；
• 方案二操作简单，但历史记录中仍会存在行尾混乱的文件；
• 无论哪种方案，操作前都要确保本地没有未提交的变更。

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