github/gh-stack

这是什么？

核心功能

• 01创建堆叠分支，底层变更后级联 rebase 整条链。
• 02为每个分支创建 PR 并设置正确的 base 分支，在 GitHub 上关联为 Stack。
• 03通过终端界面删除、折叠、插入、重排或重命名堆叠中的分支。
• 04与 GitHub 同步堆叠状态，PR 合并后清理对应分支。
• 05一次性合并到指定 PR 为止的多个堆叠 PR。
• 06支持 Git linked worktree，并提供 `gh stack view --json` 输出。

适用场景

• 将大型功能拆成多个小 PR，让审查者逐层批准。
• 在审查意见要求修改中间层后，无需手动逐个 rebase 后续分支。
• 按从底层到顶层的顺序合并一组相互依赖的 PR。

快速上手

1. 1

   使用 GitHub CLI 安装该扩展

   gh extension install github/gh-stack
2. 2

   创建新的 stack 并检出第一个分支

   gh stack init
3. 3

   在 stack 顶部添加另一个分支

   gh stack add api-endpoints
4. 4

   打开一组 pull request

   gh stack submit

收录于专题

标签

常见问题

gh-stack 是什么？

GitHub CLI 扩展，用于管理堆叠分支与堆叠 PR，把大改动拆成一串可独立审查的小 PR。 gh-stack 是一个 GitHub CLI 扩展，用于管理堆叠 PR（Stacked PRs）。它把一个大改动拆成一组相互依赖的小分支，每个分支基于其下一层，每个 PR 的 base 指向下方分支，审查者只需看到当前这一层的差异。

gh-stack 可以免费使用吗？用的什么许可证？

gh-stack 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

gh-stack 还在维护吗？

活跃维护中。gh-stack 最近一次提交是在 2026年11月3日。

gh-stack 适合用来做什么？

将大型功能拆成多个小 PR，让审查者逐层批准。 在审查意见要求修改中间层后，无需手动逐个 rebase 后续分支。 按从底层到顶层的顺序合并一组相互依赖的 PR。

gh-stack 怎么安装和运行？

使用 GitHub CLI 安装该扩展: gh extension install github/gh-stack 创建新的 stack 并检出第一个分支: gh stack init 在 stack 顶部添加另一个分支: gh stack add api-endpoints 打开一组 pull request: gh stack submit

在哪里获取 gh-stack？

源代码和安装说明在 GitHub 上：https://github.com/github/gh-stack