2022-11-16发表2023-01-10更新 Sea 技术11 分钟读完 (大约1640个字)0次访问

Git 仓库瘦身

随着时间的推移，Git 存储库变得越来越大，或者自己误操作，把 node_moduoles、.yarn、.DS_Sore 这种大文件上传到远程仓库中，虽然后期把他们移除了，但还是会使仓库体积变大，获取仓库变得更慢，每个人都必须下载文件，因此我们需要缩减 Git 仓库体积。

（虽然我们可以使用 git clone --depth=1 --single-branch https://gitlab.example.com/<namespace>/<project_name>.git ，快速拉取代码，但依然减少不了远程仓库体积）

前置条件

安装 git-filter-repo (重写仓库删除不需要的历史记录以缩小仓库，更多用法参考Examples)
1
$ brew install git-filter-repo

分析现有仓库 top 100 大文件

1	$ git rev-list --objects --all \| grep "$(git verify-pack -v .git/objects/pack/*.idx \| sort -k 3 -n \| tail -100 \| awk '{print $1}')"

示例如下，运行du -sh可以看到当前仓库大小为 82M。

.git文件夹为81M

当前仓库 top 100 的大文件:

可以看出，大文件多数集中在.yarn文件夹内。而这个文件夹对于我们来说，是不需要使用 git 管理的。应该是早期不规范或者误操作给上传到了仓库里。虽然这个文件夹现在已经被删除了，但是提交记录还在。

前期准备工作我们已经完成了，目的很明确，清楚历史中的.yarn文件，接下来开始瘦身工作。

使用 tar 解压刚才的导出项目
1
$ tar xzf project-backup.tar.gz
使用 --bare 和 --mirror 选项从包中克隆一个新的仓库副本：
1
$ git clone --bare --mirror /path/to/project.bundle
导航到 project.git 目录
使用 git filter-repo ，分析您的仓库并查看结果，确定您要清除哪些项目：(可以忽略，前面已确定要删除的文件为.yarn)
1
$ git filter-repo --analyze
使用 git filter-repo 清除仓库历史记录中的文件。因为我们试图删除内部 refs，所以我们依靠每次运行产生的 commit-map 来告诉我们要删除哪些内部 refs。

清除特定文件：.yarn(更多用法参考Examples)
1
$ git filter-repo --path-glob '.yarn/*' --invert-paths --force
移除文件之后，可以发现本地仓库大小已缩减至 1M，瘦身很明显

git filter-repo 每次运行都会创建一个新的 commit-map 文件，并覆盖上一次运行中的 commit-map。每次运行都需要此文件。每次运行 git filter-repo 时都执行下一步。

前面操作的都是本地文件，需要提交变更记录到远程。

因为从包文件克隆会将 origin 远端设置为本地包文件，删除这个 origin 远端，并将其设置为您的仓库的 URL：
1
2
$ git remote remove origin
$ git remote add origin https://gitlab.example.com/<namespace>/<project_name>.git
强制推送你的更改以覆盖 GitLab 上的所有分支：
1
$ git push origin --force 'refs/heads/*'
受保护的分支会导致失败。要继续，您必须移除分支保护、推送，然后重新启用受保护的分支。
要从标签版本中删除大文件，请强制将您的更改推送到 GitLab 上的所有标签：
1
$ git push origin --force 'refs/tags/*'
受保护的标签会导致失败。要继续，您必须移除标签保护、推送，然后重新启用受保护的标签。
为了防止不再存在的提交的死链接，推送由 git filter-repo 创建的 refs/replace。
1
$ git push origin --force 'refs/replace/*'