VSTS Git仓库清理后新克隆仍下载冗余文件的解决方案求助

听起来你遇到的是Git历史遗留对象的问题——虽然你已经在master分支清理了那些冗余文件，但它们的记录还留在仓库的历史提交里，所以新克隆的时候Git还是会拉取这些历史对象，之后才会因为当前分支没有它们而删除。既然不能新建仓库，那彻底重写仓库历史是唯一能让新克隆不再下载这些冗余的办法，我给你一步步说怎么操作：

• 第一步：先做备份，避免操作失误
  重写历史是不可逆的操作，所以一定要先克隆一份仓库的镜像备份，留作后手：

  git clone --mirror <你的VSTS仓库URL> repo-backup.git
  

  把这个备份文件夹存到安全的地方，万一后续操作出问题还能恢复。

• 第二步：用git filter-repo彻底移除历史中的冗余文件
  Git官方现在强烈推荐用git filter-repo替代旧的git filter-branch，它更安全、高效，不容易出问题。如果你的环境里还没装这个工具：

  • Windows可以用Chocolatey安装：choco install git-filter-repo
  • Mac用Homebrew：brew install git-filter-repo
  • Linux可以通过发行版的包管理器（比如apt、yum）安装，或者直接下载官方二进制文件。

  接下来，在你的工作仓库副本里，执行命令移除那些本应被忽略的文件/路径。比如要移除node_modules/或者某个特定的冗余文件目录：

  git filter-repo --path <冗余文件的路径> --invert-paths
  

  如果有多个要移除的路径，可以重复加--path参数，比如：

  git filter-repo --path logs/ --path temp/ --invert-paths
  

  这个命令会遍历仓库的所有历史提交，把包含目标路径的文件彻底从历史中删除。

• 第三步：强制推送到远程VSTS仓库
  重写历史后，本地仓库的提交记录和远程已经完全不一致了，必须强制推送覆盖远程的历史：

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

  ⚠️ 重要提醒：这会改变远程仓库的历史，一定要提前通知所有团队成员：

  1. 暂停当前的工作，把未提交的更改备份到本地临时文件夹；
  2. 要么重新克隆仓库，要么执行git fetch origin后，用git reset --hard origin/[他们正在工作的分支名]同步（这个操作会覆盖本地未提交的更改，务必先备份）。

• 第四步：修复.gitignore并同步团队成员
  把正确的.gitignore文件重新提交并推送到仓库，确保所有团队成员都更新本地的.gitignore，避免以后再出现误提交冗余文件的情况。

• 第五步：触发VSTS仓库的垃圾回收
  有些Git托管平台（包括VSTS/Azure DevOps）会保留一段时间的历史快照，你可以登录VSTS仓库的设置页面，找到“仓库管理”或者“垃圾回收”相关的选项，触发一次垃圾回收，让平台彻底删除那些被移除的冗余对象，进一步减小远程仓库的体积。

做完这些操作后，新克隆仓库的时候就不会再下载那些冗余文件了——因为它们已经从仓库的所有历史记录里被彻底移除了。

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