单体仓库与 Git 子模块
了解单体仓库与多仓库设置之间的权衡,以及 Git 子模块如何将一个仓库嵌入另一个仓库。
单体仓库与 Git 子模块 是 CoddyKit 上的免费 Git & GitHub Professional Workflow 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Git & GitHub Professional Workflow 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Git & GitHub Professional Workflow 课程共包含 4 节课。
单仓库与多仓库
单仓库会将多个项目存储在一个仓库中。多仓库方案则让每个项目拥有自己的仓库。两种方案在大规模场景中都很常见。
团队为何选择单仓库
单仓库便于:
- 在项目之间共享代码
- 以原子方式跨边界重构
- 使用一套持续集成流程和一套版本方案
单仓库的挑战
大型单仓库可能不断膨胀,导致克隆和持续集成变慢。稀疏检出和构建缓存等工具有助于管理这种情况。
什么是子模块
子模块 是嵌入另一个仓库中的独立 Git 仓库,并固定在某个提交上。外层仓库会跟踪要使用的内层仓库提交。
添加子模块
使用 git submodule add 将外部仓库嵌入指定路径。
git submodule add https://github.com/org/shared-lib libs/shared.gitmodules 文件
Git 会在仓库根目录下受跟踪的 .gitmodules 文件中记录每个子模块的路径和网址。
[submodule 'libs/shared']
path = libs/shared
url = https://github.com/org/shared-lib克隆并包含子模块
普通克隆会让子模块文件夹保持为空。请使用递归标志同时获取它们。
git clone --recurse-submodules https://github.com/org/app初始化现有子模块
如果您已经完成克隆,请使用初始化和更新命令拉取子模块内容。
git submodule update --init --recursive更新子模块
子模块会固定在某个提交上。要更新到最新版本,请在子模块中进行更新,然后在父仓库中提交新的指针。
git submodule update --remote libs/shared
git add libs/shared
git commit -m 'Bump shared lib'子模块与子树的比较
git subtree 是一种替代方案,它会直接合并另一个仓库的内容,避免固定指针带来的复杂性,但会失去清晰的分离性。
选择方法
对于紧密耦合的项目,请使用单一仓库;要嵌入共享但独立版本管理的库,请使用子模块;团队完全自治时,请使用多仓库。
快速检查
检验您对单一仓库和子模块的理解。
回顾
您已经了解了单一仓库和子模块:
- 单一仓库集中管理多个项目;多仓库则将它们分开
- 子模块通过
.gitmodules嵌入一个固定在某个提交上的仓库 - 使用
--recurse-submodules进行克隆 - 子树是另一种嵌入策略
常见问题解答
「单体仓库与 Git 子模块」课时是免费的吗?
是的 — 「单体仓库与 Git 子模块」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Git & GitHub Professional Workflow 课程的其余内容,请升级到 CoddyKit PRO。 Git & GitHub Professional Workflow 课程共包含 4 节课。
「单体仓库与 Git 子模块」这节课中我会学到什么?
了解单体仓库与多仓库设置之间的权衡,以及 Git 子模块如何将一个仓库嵌入另一个仓库。 你通过在浏览器中直接运行的动手代码来练习 Git & GitHub Professional Workflow,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Git & GitHub Professional Workflow 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Git & GitHub Professional Workflow 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「单体仓库与 Git 子模块」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Git & GitHub Professional Workflow 课中编写并运行代码吗?
能。每节 Git & GitHub Professional Workflow 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- IDE 与开发工具中的 Git
- 企业级 Git 解决方案
- 为大型团队扩展 Git
- 单体仓库与 Git 子模块