gh stack 导航命令完全指南up、down、top、bottom、trunk、switch 快速切换层【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stackgh stack 是 GitHub 官方的 Stacked PRs堆叠式 PR命令行工具把多个 PR 按依赖关系叠成一层层积木。当你的特性被拆成多个 PR 时gh stack 导航命令up、down、top、bottom、trunk、switch能让你在栈的任意一层之间快速切换分支无需记分支名、无需手动git checkout。本文带你逐条掌握这 6 个高频使用的分支切换命令。先建立一个心智模型栈的**底部bottom**是离主干trunk如main最近的分支**顶部top**是离主干最远的分支。up向上远离主干走down向下靠近主干走top/bottom直接跳到两端trunk跳回主干switch打开交互式选择器。为什么需要 gh stack 分支导航堆叠式 PR 的典型场景是一个大型特性拆成 3 个 PR——数据库 schema、API 接口、前端页面。每合并一个下一个 PR 才会通过 review。这时你经常需要在层与层之间来回穿梭底层 PR 被要求修改 → 修完再回到顶层继续写代码。手动切换要git checkout 分支名记名字既慢又容易出错。gh stack 导航命令用相对位置代替分支名让你永远只输入up/down这样的短指令。完整使用流程可参考官方工作流文档 workflows.md。六个导航命令速查表命令作用是否可带层数源码位置gh stack up [n]向上远离主干移动 n 层默认 1 层✅navigate.gogh stack down [n]向下靠近主干移动 n 层默认 1 层✅navigate.gogh stack top跳到栈顶离主干最远的分支❌navigate.gogh stack bottom跳到底部离主干最近的分支❌navigate.gogh stack trunk切回主干分支如 main❌trunk.gogh stack switch交互式选择器可视化切换任意层❌switch.goup / down相对移动支持一次跨多层gh stack up # 向上移动一层 gh stack up 3 # 一次向上移动三层 gh stack down # 向下移动一层 gh stack down 2 # 一次向下移动两层三个贴心细节自动跳过已合并分支某层 PR 已合并后导航会直接越过它并在输出中提示Skipped n merged branch避免你停在过时的分支上边界安全钳制在栈顶继续up或栈底继续down不会报错只提示Already at the top/bottom of the stack在主干上时up一步入栈如果你正站在main上gh stack up会直接切到栈的第一个分支。top / bottom两端直达gh stack top # 跳到栈顶 gh stack bottom # 跳到底部官方工作流中最高频的组合就是底层修 bug 回到顶层继续写gh stack bottom # 1. 跳到最底层处理 review 意见 # ... 修改代码并 commit ... gh stack rebase --upstack # 2. 让上层分支继承这次修改 gh stack top # 3. 回到顶层继续开发注意bottom的语义它切到的是未合并的最底层分支如果整条栈都已合并会给出警告并回退到第一个分支。trunk一键回到 maingh stack trunktrunk命令把当前栈的主干分支通常是main或develop检出到本地。两个实用点本地缺主干分支时自动创建如果本地还没有main的本地引用命令会自动解析远端并建立本地分支再切换省去手动git fetch的麻烦实现见 runTrunk前提是在栈内当前分支必须属于某个栈否则会提示not in a stack。典型的出栈操作就是gh stack trunk——比如临时切回 main 看最新代码或跑构建。switch可视化交互式切换gh stack switch当你不确定目标层的位置、或者一次要跳很多层时switch会打开一个交互式选择器按从栈顶到底部的顺序编号列出所有分支Select a branch in the stack to switch to: 5. frontend 4. api-endpoints 3. auth-layer 2. db-schema 1. config-setup用方向键上下移动、回车确认即可切换。选择器默认高亮你当前所在的分支见 runSwitch。它需要交互式终端CI 等非交互环境下不可用。选型建议只移动一两层用up/down最快敲三个字母跳两端用top/bottom回主干用trunk层数多、记不清位置时用switch看图选。实战review 意见修复的完整切换流程假设你的栈有 4 层config-setup→db-schema→auth-layer→frontendreviewer 在中间层auth-layer提了修改意见gh stack switch # 1. 打开选择器选中 auth-layer git add . git commit -m Address review feedback gh stack rebase # 2. 级联 rebase让上层分支继承修改 gh stack push # 3. 安全强推更新所有分支 gh stack top # 4. 回到栈顶继续开发整套流程没有任何一次手写分支名这正是 gh stack 导航命令的核心价值。小结up [n]/down [n]相对移动自动跳过已合并分支边界安全top/bottom栈两端直达适合修底层再回顶层的高频场景trunk一键回 main本地缺分支时自动从远端创建switch交互式可视化选择器层多时最省心所有导航命令的实现集中在 cmd/navigate.go 与 cmd/switch.go命令参考可查阅 cli.md配合 workflows.md 中的级联 rebase 流程就能把堆叠 PR 的日常开发节奏完全跑顺。【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
gh stack 导航命令完全指南：up、down、top、bottom、trunk、switch 快速切换层
gh stack 导航命令完全指南up、down、top、bottom、trunk、switch 快速切换层【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stackgh stack 是 GitHub 官方的 Stacked PRs堆叠式 PR命令行工具把多个 PR 按依赖关系叠成一层层积木。当你的特性被拆成多个 PR 时gh stack 导航命令up、down、top、bottom、trunk、switch能让你在栈的任意一层之间快速切换分支无需记分支名、无需手动git checkout。本文带你逐条掌握这 6 个高频使用的分支切换命令。先建立一个心智模型栈的**底部bottom**是离主干trunk如main最近的分支**顶部top**是离主干最远的分支。up向上远离主干走down向下靠近主干走top/bottom直接跳到两端trunk跳回主干switch打开交互式选择器。为什么需要 gh stack 分支导航堆叠式 PR 的典型场景是一个大型特性拆成 3 个 PR——数据库 schema、API 接口、前端页面。每合并一个下一个 PR 才会通过 review。这时你经常需要在层与层之间来回穿梭底层 PR 被要求修改 → 修完再回到顶层继续写代码。手动切换要git checkout 分支名记名字既慢又容易出错。gh stack 导航命令用相对位置代替分支名让你永远只输入up/down这样的短指令。完整使用流程可参考官方工作流文档 workflows.md。六个导航命令速查表命令作用是否可带层数源码位置gh stack up [n]向上远离主干移动 n 层默认 1 层✅navigate.gogh stack down [n]向下靠近主干移动 n 层默认 1 层✅navigate.gogh stack top跳到栈顶离主干最远的分支❌navigate.gogh stack bottom跳到底部离主干最近的分支❌navigate.gogh stack trunk切回主干分支如 main❌trunk.gogh stack switch交互式选择器可视化切换任意层❌switch.goup / down相对移动支持一次跨多层gh stack up # 向上移动一层 gh stack up 3 # 一次向上移动三层 gh stack down # 向下移动一层 gh stack down 2 # 一次向下移动两层三个贴心细节自动跳过已合并分支某层 PR 已合并后导航会直接越过它并在输出中提示Skipped n merged branch避免你停在过时的分支上边界安全钳制在栈顶继续up或栈底继续down不会报错只提示Already at the top/bottom of the stack在主干上时up一步入栈如果你正站在main上gh stack up会直接切到栈的第一个分支。top / bottom两端直达gh stack top # 跳到栈顶 gh stack bottom # 跳到底部官方工作流中最高频的组合就是底层修 bug 回到顶层继续写gh stack bottom # 1. 跳到最底层处理 review 意见 # ... 修改代码并 commit ... gh stack rebase --upstack # 2. 让上层分支继承这次修改 gh stack top # 3. 回到顶层继续开发注意bottom的语义它切到的是未合并的最底层分支如果整条栈都已合并会给出警告并回退到第一个分支。trunk一键回到 maingh stack trunktrunk命令把当前栈的主干分支通常是main或develop检出到本地。两个实用点本地缺主干分支时自动创建如果本地还没有main的本地引用命令会自动解析远端并建立本地分支再切换省去手动git fetch的麻烦实现见 runTrunk前提是在栈内当前分支必须属于某个栈否则会提示not in a stack。典型的出栈操作就是gh stack trunk——比如临时切回 main 看最新代码或跑构建。switch可视化交互式切换gh stack switch当你不确定目标层的位置、或者一次要跳很多层时switch会打开一个交互式选择器按从栈顶到底部的顺序编号列出所有分支Select a branch in the stack to switch to: 5. frontend 4. api-endpoints 3. auth-layer 2. db-schema 1. config-setup用方向键上下移动、回车确认即可切换。选择器默认高亮你当前所在的分支见 runSwitch。它需要交互式终端CI 等非交互环境下不可用。选型建议只移动一两层用up/down最快敲三个字母跳两端用top/bottom回主干用trunk层数多、记不清位置时用switch看图选。实战review 意见修复的完整切换流程假设你的栈有 4 层config-setup→db-schema→auth-layer→frontendreviewer 在中间层auth-layer提了修改意见gh stack switch # 1. 打开选择器选中 auth-layer git add . git commit -m Address review feedback gh stack rebase # 2. 级联 rebase让上层分支继承修改 gh stack push # 3. 安全强推更新所有分支 gh stack top # 4. 回到栈顶继续开发整套流程没有任何一次手写分支名这正是 gh stack 导航命令的核心价值。小结up [n]/down [n]相对移动自动跳过已合并分支边界安全top/bottom栈两端直达适合修底层再回顶层的高频场景trunk一键回 main本地缺分支时自动从远端创建switch交互式可视化选择器层多时最省心所有导航命令的实现集中在 cmd/navigate.go 与 cmd/switch.go命令参考可查阅 cli.md配合 workflows.md 中的级联 rebase 流程就能把堆叠 PR 的日常开发节奏完全跑顺。【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
