🧱 使用 starter-xx 模板仓库并回推更新到模板仓库的流程
建了几个自己的项目模板仓库 starter-xx,可以通过 Use this template 创建新仓库。
但问题是:模板仓库可能长时间未更新依赖,导致 创建的新仓库依赖落后。
理想流程是:
🧩 直接
Use template→ 🚀 在新仓库升级依赖 → 🔁 回推到模板仓库
🔁 最佳实践流程步骤
1️⃣ 从模板仓库创建新项目仓库
- 仓库 A 是模板仓库,例如:
starter-vue-lib - 点击 GitHub 的 Use this template,生成新仓库 B

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

4️⃣ 添加远程模板仓库 A 为上游
git remote add upstream https://github.com/pinky-pig/starter-vue-lib
git remote -v # ✅ 检查是否添加成功
VSCode 操作:

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

5️⃣ 创建远程模板仓库 A 的分支 C
# fetch 一下
git fetch upstream
# 因为添加远程仓库的时候,仓库名字命名为 upstream ,所以这里的仓库名都是 upstream 了
git checkout -q -b update-deps --no-track upstream/main
在 VSCode 图形界面操作:,也能发现执行的是同一个命令:

6️⃣ 在分支 C 并合并 B 的分支的更新(解决无关联历史)
当前在刚创建的分支 C 上,代码是跟仓库 A 一致的,需要合并刚才在 B 上更新的代码。
git merge main --allow-unrelated-histories
7️⃣ 推送合并结果到模板仓库 A
git push -u starter-vue-lib update-deps


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

