🧱 使用 starter-xx 模板仓库并回推更新到模板仓库的流程

建了几个自己的项目模板仓库 starter-xx,可以通过 Use this template 创建新仓库。
但问题是:模板仓库可能长时间未更新依赖,导致 创建的新仓库依赖落后。

理想流程是:

🧩 直接 Use template → 🚀 在新仓库升级依赖 → 🔁 回推到模板仓库


🔁 最佳实践流程步骤

1️⃣ 从模板仓库创建新项目仓库

  • 仓库 A 是模板仓库,例如:starter-vue-lib
  • 点击 GitHub 的 Use this template,生成新仓库 B

Image


2️⃣ 克隆新仓库 B 到本地

git clone https://github.com/pinky-pig/vue-ai-orb.git
cd vue-ai-orb

3️⃣ 升级依赖并提交更新

使用项目里的脚本进行依赖升级,例如:

pnpm run up

然后提交并推送到仓库 B:

git add .
git commit -m "chore: upgrade deps"
git push origin main

Image

4️⃣ 添加远程模板仓库 A 为上游

git remote add upstream https://github.com/pinky-pig/starter-vue-lib
git remote -v  # ✅ 检查是否添加成功

VSCode 操作:

Image

然后在弹出的 input 输入框中写入仓库 A 地址就好了

Image

5️⃣ 创建远程模板仓库 A 的分支 C

# fetch 一下
git fetch upstream
# 因为添加远程仓库的时候,仓库名字命名为  upstream ,所以这里的仓库名都是 upstream 了
git checkout -q -b update-deps --no-track upstream/main

在 VSCode 图形界面操作:,也能发现执行的是同一个命令:

Image

6️⃣ 在分支 C 并合并 B 的分支的更新(解决无关联历史)

当前在刚创建的分支 C 上,代码是跟仓库 A 一致的,需要合并刚才在 B 上更新的代码。

git merge main --allow-unrelated-histories

7️⃣ 推送合并结果到模板仓库 A

git push -u starter-vue-lib update-deps

Image

Image

8️⃣ 在 GitHub 上发起 PR 合并

  • 打开模板仓库 A(例如 starter-vue-lib)的 GitHub 页面
  • 你会看到一个 PR,来自分支 starter-vue-lib-update
  • ✅ 审查 & 合并
  • 合并 pr 页面下面会有一个“Delete branch” 按钮,点击删除分支(如果没有仓库 A 的权限,不会创建这个新分支;如果有 A 的权限,那么新建一个 merge 的分支,在合并的时候删除就好了)

Image

Image