如何为Git仓库的所有提交添加.gitignore文件？

要给仓库的每一个提交（包括所有分支、标签）都添加.gitignore文件，可以用git filter-repo工具重写整个提交历史——这是官方推荐替代旧版git filter-branch的高效稳定方案，具体步骤如下：

前置准备 #

1. 准备标准.gitignore文件：写好符合需求的忽略规则，将文件保存到仓库外的固定路径（比如~/standard.gitignore），避免重写过程中被覆盖。
2. 备份仓库：重写历史属于破坏性操作，务必复制整个仓库文件夹做本地备份，或推送到临时远程仓库留存副本。
3. 安装git filter-repo：新版Git已内置该工具，若未预装可通过pip install git-filter-repo完成安装。

执行历史重写 #

在仓库根目录运行以下命令，将指定的.gitignore文件添加到每一个提交的根目录（若提交中已有.gitignore，会被替换为新文件）：

git filter-repo --tree-filter 'cp /绝对路径/到/你的/standard.gitignore .gitignore'

注意替换命令中的/绝对路径/到/你的/standard.gitignore为你实际的文件路径，确保路径准确无误。

后续操作 #

1. 验证结果：切换到各个分支、标签，用git log --oneline遍历提交，再通过git show <commit-id>:./.gitignore确认每个提交都包含正确的.gitignore。
2. 强制推送远程仓库：由于历史已被重写，需要强制覆盖远程的所有分支和标签：

   git push --force --all
   git push --force --tags
   

3. 同步团队协作环境：通知所有协作开发者，要么重新克隆仓库，要么执行以下命令同步（会丢失本地未提交的修改，请提前做好备份）：

   git fetch --all
   git reset --hard origin/<目标分支名>
   

注意事项 #

• 不要在公共仓库随意执行强制推送，确保所有团队成员都知晓并准备好同步新历史。
• 如果之前使用过git filter-branch导致残留旧引用，可执行以下命令清理：

  git for-each-ref --format="delete %(refname)" refs/original | git update-ref --stdin
  git reflog expire --expire=now --all
  git gc --prune=now
  

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