要使用 git subtree 添加一个新的子仓库，可以按照以下步骤操作：

1. 添加子仓库

使用 git subtree add 命令将子仓库的内容添加到主仓库的指定目录中。命令格式如下：

git subtree add --prefix=<子目录路径> <子仓库地址> <子仓库分支>

• --prefix=<子目录路径>：指定子仓库在主仓库中的目录路径。
• <子仓库地址>：子仓库的 Git 仓库 URL。
• <子仓库分支>：子仓库中要添加的分支名称。

示例

假设你希望将 https://github.com/example/subproject.git 的 main 分支作为子仓库添加到主仓库的 subproject 目录中，可以执行以下命令：

git subtree add --prefix=subproject https://github.com/example/subproject.git main

2. 提交更改

添加子仓库后，Git 会自动创建一个提交，将子仓库的内容合并到主仓库中。你可以通过以下命令查看并提交这些更改：

git status
git commit -m "Add subproject as a subtree"
git push

3. 更新子仓库

如果子仓库有新的更改，可以使用以下命令将这些更改拉取到主仓库中：

git subtree pull --prefix=<子目录路径> <子仓库地址> <子仓库分支>

例如：

git subtree pull --prefix=subproject https://github.com/example/subproject.git main

这会将子仓库的最新更改合并到主仓库中。

4. 推送子仓库的更改

如果你在主仓库的子目录中进行了更改，并希望将这些更改推送到子仓库中，可以使用以下命令：

git subtree push --prefix=<子目录路径> <子仓库地址> <子仓库分支>

例如：

git subtree push --prefix=subproject https://github.com/example/subproject.git main

这会将主仓库中子目录的更改推送到子仓库的指定分支。

注意事项

• 如果希望在添加子仓库时简化提交历史，可以使用 --squash 选项。这会将子仓库的提交历史压缩为一个单一的提交。
• 确保子仓库的分支名称和路径正确无误，否则可能会导致命令失败。

通过以上步骤，你可以轻松地将一个新的子仓库添加到主仓库中，并在需要时同步更改。