用途:将大型功能拆分为逻辑清晰、相互依赖的小型 PR,便于增量合并与评审。适合功能跨多个逻辑步骤(前后端、模型加界面)、变更超过约 300 行 diff、可增量合并的场景;单一用途缺陷修复、小而独立的改动、单文件内重构则不建议堆叠。
前置条件:安装并认证 GitHub CLI(创建 PR 必需)。命令:brew install gh(macOS)或 sudo apt install gh(Ubuntu/Debian),然后 gh auth login。
核心用法:从 main 创建第一个分支并提交推送(示例分支 feat/user-api);再从当前分支创建依赖分支(如 feat/user-ui)继续开发。分支命名建议 feat/<feature>-1-<step>、feat/<feature>-2-<step> 等,例如 feat/dark-mode-1-theme-context。在 PR 描述中加入堆叠上下文,注明依赖的 PR 编号与被后续 PR 跟随的关系。合并顺序为自下而上:先合并基础 PR,将依赖 PR 变基到更新后的 main,再合并下一个,直到整个堆叠合并完成。
变基:基础分支更新后,先拉取基础分支最新内容,切到依赖分支执行 git rebase 基础分支,再使用 git push --force-with-lease 推送(仅限分支,绝不用于 main)。参考资料包含工作流步骤与变基指南文档(references/workflow-steps.md、references/rebase-guide.md)。
限制与缺失:价格、平台支持、效果等资料暂未提供。