repo init --reference缩减构建存储空间的原理及使用注意事项

底层空间缩减实现原理 #

repo的--reference参数基于Git原生的*对象替代（alternates）*机制实现空间复用：

每个Git仓库的.git/objects目录默认存储该仓库所有的提交记录、文件快照、分支标签等元数据，全量同步的385GB空间里90%以上都是这部分重复的Git对象数据。
当你在repo init时指定--reference参数后，repo会为工作目录下的每个Git仓自动生成.git/objects/info/alternates文件，指向参考镜像目录中对应Git仓的对象存储路径。Git执行操作时会优先读取本地存储的对象，本地不存在的对象直接从参考镜像目录读取，无需再从远端拉取也不会重复存储到本地工作目录，因此大幅降低了空间占用和同步耗时。

63GB空间存储的具体内容 #

你观察到的63GB占用主要包含两部分内容：

• 工作目录下所有Git仓的本地独有元数据：包括当前分支指针、暂存区记录、本地未推送的提交、同步时参考镜像中不存在的新增上游提交对象等，这部分数据量非常小，通常只占几GB以内。
• 全量检出的Android源码工作区文件：就是你同步完成后可直接编辑、编译的明文源码文件，这部分固定占用60GB左右，也是63GB占用的主要组成部分。

编译风险说明 #

正常使用场景下不会引发任何编译问题：
编译系统只会读取工作目录下已检出的明文源码文件，完全感知不到Git底层的对象复用逻辑，参考镜像的存在对编译流程完全透明。仅当参考镜像目录被删除、损坏或无读取权限时，只会影响repo sync、git checkout等Git操作，不会影响已经完成检出的工作目录的编译流程。

使用注意事项 #

• 参考镜像目录必须保持稳定可用：
  • 不要随意修改、删除参考镜像内的文件，一旦参考镜像损坏后所有关联的工作目录的Git操作都会失效，需要重新全量同步才能恢复。
  • 给所有使用参考镜像的用户配置只读权限即可，避免误操作破坏镜像内容。
• 定期同步参考镜像：如果参考镜像长时间未和远端同步，上游新增的提交无法被复用，本地同步时会拉取大量镜像中不存在的对象存储到本地，逐渐推高本地工作目录的空间占用，定期同步镜像可保持本地空间占用稳定。
• 镜像首次创建必须使用repo init --mirror参数同步，保证镜像包含所有分支、标签、提交记录，避免出现Git操作时找不到对象的报错。
• 如果需要将工作目录迁移到无参考镜像的环境使用，可在工作目录下执行repo forall -c 'git repack -a -d -l'命令，将参考镜像中的依赖对象全部打包到本地Git仓，即可脱离参考镜像独立使用。

命令示例 #

你当前使用的参数配置符合规范，正确写法如下：

export Mirror="/data/Android-s"
repo init -u ssh://$US...@android1.test.com:29418/android/manifest -b tmainline -m t-r-mainline.xml --repo-url=ssh://android1.test.com:29418/android1/repo --repo-branch=test-stable --no-repo-verify --reference=$Mirror

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