如何通过Git subtree在新仓库构建core根目录与module1子目录结构？

我来帮你梳理下正确的配置步骤，以及你可能踩中的坑——Git Subtree的路径指定和命令顺序很容易出错，咱们一步步来：

先明确核心需求 #

你要在新仓库（就叫它project4吧）的master分支实现：

• 把core仓库作为根目录的Subtree（包含Angular应用、各类文件夹及app/modules目录）
• 把module1仓库挂载到project4的./app/modules路径下（也就是core自带的app/modules目录里）

分步操作指南 #

1. 初始化新仓库（如果还没创建） #

先确保你在干净的环境下操作：

# 创建并进入新仓库目录
mkdir project4 && cd project4
git init
git checkout -b master  # 确保当前是master分支

2. 挂载Core到根目录 #

这一步的关键是指定根目录作为Subtree的前缀，命令格式如下：

# 替换成你的core仓库实际地址，--squash可选（合并提交历史，避免仓库臃肿）
git subtree add --prefix=./ git@xxx.com/your-repo/core.git master --squash

执行完这个命令后，project4的根目录就会完全同步core仓库master分支的内容，包括自带的app/modules目录。

3. 挂载Module1到app/modules路径 #

现在core的app/modules已经存在（如果原来core里这个目录有内容，先手动移走或删除并提交，避免冲突），执行以下命令挂载module1：

# 替换成你的module1仓库实际地址
git subtree add --prefix=app/modules git@xxx.com/your-repo/module1.git master --squash

4. 验证结果 #

执行完后，检查目录结构：

ls -la  # 根目录应该是core的完整内容
ls app/modules  # 这里应该是module1的所有文件

常见失败原因及解决办法 #

1. 路径冲突：如果core的app/modules原本有文件，subtree add会报错。解决方式：先把core里app/modules的文件临时移到其他目录，提交后再执行module1的挂载命令，之后按需合并文件。
2. 前缀指定错误：比如误把前缀写成绝对路径（多了根路径斜杠/）就会出错，确保前缀是相对于当前仓库根目录的相对路径（比如app/modules或./app/modules都可以）。
3. 远程仓库权限问题：如果是私有仓库，检查本地Git的SSH密钥是否配置正确，或者HTTPS凭证是否已保存（避免拉取时提示权限不足）。
4. 命令顺序错误：必须先挂载core到根目录，再挂载module1到app/modules——因为app/modules是core带来的路径，提前挂载module1会因为路径不存在而失败。

后续维护命令 #

• 更新core的最新代码：

git subtree pull --prefix=./ git@xxx.com/your-repo/core.git master --squash

• 更新module1的最新代码：

git subtree pull --prefix=app/modules git@xxx.com/your-repo/module1.git master --squash

• 把project4中core的修改推回原仓库：

git subtree push --prefix=./ git@xxx.com/your-repo/core.git master

• 把project4中module1的修改推回原仓库：

git subtree push --prefix=app/modules git@xxx.com/your-repo/module1.git master

内容的提问来源于stack exchange，提问作者Ricardo Daniel