如何将GitHub模板仓库的更新导入到自己生成的仓库

问题核心原因 #

通过GitHub模板功能生成的仓库会重写初始提交，和原模板仓库不存在共同的Git祖先节点，因此直接拉取原模板分支合并会出现大量无关历史冲突，这就是尝试方案1失败的根本原因。

最优方案操作指南 #

你判断的方案2确实是当前已生成仓库场景下冲突最小、可复用性最高的方案，具体可按以下步骤执行：

首次配置步骤 #

• 添加原模板仓库为远端上游，命名为upstream：

git remote add upstream <原模板仓库的Git地址>

• 拉取上游仓库所有分支信息：

git fetch upstream

• 基于上游的stable分支创建专属的模板同步分支：

git checkout -b template_sync upstream/stable

• 切回你自己的业务开发主分支（比如main、master或你自己的stable分支）：

git checkout <你的主分支名>

每次模板更新后的同步步骤 #

• 拉取上游仓库的最新更新：

git fetch upstream

• 切换到同步分支，拉取模板stable分支的最新代码：

git checkout template_sync && git pull upstream stable

• 查看模板更新的提交记录，获取上次同步后新增的所有commit哈希范围：

git log --oneline

• 切回自己的主分支，按提交顺序批量cherry-pick更新：

git checkout <你的主分支名>
git cherry-pick <最早的新增commit哈希>^..<最晚的新增commit哈希>

• 若出现冲突，按提示解决冲突后执行git cherry-pick --continue，直到所有提交同步完成即可。

其他方案的适用场景 #

• 方案3：仅适合模板更新内容少于3处的极轻量场景，更新内容较多时容易遗漏改动，不推荐常规使用
• 方案4：如果你后续需要长期高频跟进模板的迭代更新，改用fork形式是长期成本更低的选择。fork仓库和原仓库天然共享祖先节点，后续同步只需直接合并上游分支即可，不会出现无共同历史的冲突问题。如果你的现有仓库已经有大量业务提交，不需要做迁移。

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