git_子仓库的添加

在 GitLab 的 Git 代码库中添加子 Git 代码库，通常指的是使用 Git 子模块 (Git Submodule) 或 Git 子树 (Git Subtree)。最常用和推荐的方法是 Git 子模块。

以下是使用 Git 子模块 (Submodule) 的详细步骤：
方法一：使用 Git 子模块 (推荐)

Git 子模块允许你将一个 Git 仓库作为另一个 Git 仓库的子目录。它能保持各自的独立版本控制。

1. 添加子模块

在你的主项目根目录下运行以下命令：

git submodule add <子模块仓库的URL> <子模块在主项目中的路径>

例如，将一个名为 common-utils 的 GitLab 项目添加为 libs/common 目录下的子模块：

git submodule add https://gitlab.com/your-group/common-utils.git libs/common

注意：确保你有权限访问该子模块仓库（使用 HTTPS 或 SSH URL）。

2. 提交更改

添加子模块后，Git 会生成两个文件：

.gitmodules：记录子模块的配置信息（URL、路径等）。
一个以子模块路径为名的 gitlink（特殊条目）。

提交这些更改：

git commit -m "添加 common-utils 作为子模块"
git push origin main  # 或你的分支名

3. 克隆包含子模块的项目

当其他人克隆你的主项目时，需要额外步骤来初始化和更新子模块：

# 克隆主项目
git clone https://gitlab.com/your-group/your-main-project.git
cd your-main-project

# 初始化并更新子模块
git submodule init
git submodule update

# 或者一步完成
git submodule update --init --recursive

4. 更新子模块

进入子模块目录，拉取最新代码：

cd libs/common
git pull origin main

然后在主项目中提交子模块的引用更新：

cd ..
git add libs/common
git commit -m "更新 common-utils 子模块到最新版本"

方法二：使用 Git 子树 (Git Subtree)

git subtree 将另一个仓库的代码合并到你的项目中，但历史记录会合并在一起，不像子模块那样保持独立。
添加子树

git subtree add --prefix=libs/common https://gitlab.com/your-group/common-utils.git main --squash

--prefix：指定子目录路径。
--squash：将子项目的历史压缩为一次提交（可选）。

拉取子树更新

git subtree pull --prefix=libs/common https://gitlab.com/your-group/common-utils.git main --squash

推送更改回子项目（可选）

如果你修改了子树中的代码并想推回原仓库：

git subtree push --prefix=libs/common https://gitlab.com/your-group/common-utils.git new-branch

总结

方法 优点 缺点 适用场景
子模块 (Submodule) 保持子项目独立，版本清晰 克隆和更新稍复杂，需要额外命令 多个项目共享同一组件，希望独立维护
子树 (Subtree) 使用简单，像普通目录一样 历史记录混合，推送回原项目较复杂 子项目不常更新，或希望简化协作流程
GitLab UI 是否支持？

GitLab 的 Web 界面 不直接支持 添加子模块或子树。你必须使用命令行或本地 Git 工具进行操作。但 .gitmodules 文件会在 GitLab 中正常显示。