gh stack view完全参考用--short和--json掌握Stack状态【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stackgh stack view是 gh-stack 堆叠 PR 工具中查看 Stack 状态的核心命令。一条命令列出当前 Stack 的所有分支、每个 PR 的合并/排队/开放状态和是否需要 rebase并提供三种输出形态交互式视图、--short紧凑视图和--json机器可读视图——前两者给人看最后一种专为脚本和 AI Agent 设计 。三种查看模式各取所需gh stack view的完整实现位于 cmd/view.go三种模式一眼区分模式命令适用场景特点交互式 TUIgh stack view日常开发全屏界面支持鼠标可切换分支紧凑视图gh stack view --short快速扫一眼每个分支一行带状态图标JSON 输出gh stack view --json脚本/CI/AI无交互提示带类型化退出码无论使用哪种模式命令都会先从 GitHub 同步一次 PR 最新状态再展示所以你看到的就是当前真实状态而不是本地缓存的旧数据。默认交互视图分支、提交、PR 一站看全在交互式终端中直接运行gh stack view会打开一个全屏 TUI基于 Alt Screen 渲染支持鼠标操作。它会展示 每个分支在 Stack 中的位置和当前分支高亮 每个分支的最新提交短 SHA、相对时间如 3 days ago和提交标题 分支对应的 PR 链接✅ 状态图标下一节详解在 TUI 中选定某个分支后退出还可以直接把它 checkout 出来省去再敲一次git checkout。在非交互式环境如管道或 CI中命令会自动退化为静态文本输出并通过分页器展示——遵循GIT_PAGER、PAGER环境变量默认less -R。--short 紧凑模式分支状态一行看穿gh stack view --short--short可简写为-s输出紧凑的单行视图是整个命令中信息密度最高的模式。它的结构自上而下是Stack #NStack 编号粗体与 GitHub 界面上的编号一致活跃分支区当前分支以»开头并标注(current)queued分隔线进入合并队列的分支merged分隔线已合并的分支灰色显示└ main底部的 trunk 分支每个分支行后面还跟着彩色 PR 编号绿色开放紫色已合并一眼定位要处理的 PR。状态图标速查四种图标源码定义见 cmd/view.go 的branchStatusIndicator图标含义颜色✓PR 已合并紫色◎PR 已进入合并队列黄色○PR 处于开放状态绿色⚠分支需要 rebase基分支不是其祖先黄色⚠图标尤其值得关注它说明 Stack 历史不线性了此时运行gh stack rebase做级联 rebase 即可恢复。--json 机器可读模式把 Stack 状态喂给脚本和 AIgh stack view --json--json是自动化场景的瑞士军刀 。它有两个关键设计见 cmd/view.go 中runViewJSON永不弹出交互式提示——Agent 和脚本总能拿到干净的机器可读输出返回类型化退出码——脚本可以据此分支处理而不是解析错误文案输出结构固定为三个顶层字段{ trunk: main, currentBranch: feat/02, branches: [ { name: feat/01, head: bbb222, base: aaa111, isCurrent: false, isMerged: true, isQueued: false, needsRebase: false, pr: { number: 42, url: …, state: MERGED } } ] }字段速查表完整字段行为见 cmd/view_test.go 中的断言字段说明trunkStack 底部的 trunk 分支名currentBranch当前所在分支branches[].name/head/base分支名、HEAD 与基分支的 SHAbranches[].isCurrent是否为当前分支branches[].isMerged/isQueuedPR 是否已合并 / 已入合并队列branches[].needsRebase是否需要 rebase已合并分支恒为falsebranches[].pr.stateOPEN/MERGED/QUEUED三选一branches[].pr无 PR 时整个字段省略不会输出null配合jq这类工具哪些分支需要 rebase、栈顶是哪个分支这类问题都变成一行管道命令的事。退出码速查脚本怎么判断结果gh stack view --json用不同退出码区分失败原因便于自动化决策退出码含义建议处理0成功正常解析 JSON1一般错误记录日志2不在任何 Stack 中 / 未找到 Stack提示先gh stack init4GitHub API 调用失败检查认证或稍后重试6需要消歧当前分支属于多个 Stack先 checkout 一个非 trunk 分支再试 退出码6是最容易踩的坑当你在main上、且仓库里存在多个共用该 trunk 的 Stack 时就会触发。切到任意一个具体分支即可消除歧义。实用搭配建议日常开发跑gh stack view看全景跑之前先瞟一眼--short确认没有⚠AI Agent 集成统一使用--json靠退出码做分支判断无需解析彩色文本rebase 后验证gh stack rebase完成后再--json一次确认needsRebase全部归零命令的更多上下文如sync、rebase如何影响 view 展示的状态可在 docs/src/content/docs/reference/cli.md 中查阅。总结gh stack view一个命令、三种形态覆盖了 Stack 状态查看的全部场景需求用哪个看提交、切分支、浏览 PR交互式 TUI终端里快速确认状态--short 四种状态图标脚本 / CI / AI Agent 消费状态--json 退出码掌握它你就随时知道自己的 Stack 走到了哪一步 ✅。【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
gh stack view完全参考：用--short和--json掌握Stack状态
gh stack view完全参考用--short和--json掌握Stack状态【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stackgh stack view是 gh-stack 堆叠 PR 工具中查看 Stack 状态的核心命令。一条命令列出当前 Stack 的所有分支、每个 PR 的合并/排队/开放状态和是否需要 rebase并提供三种输出形态交互式视图、--short紧凑视图和--json机器可读视图——前两者给人看最后一种专为脚本和 AI Agent 设计 。三种查看模式各取所需gh stack view的完整实现位于 cmd/view.go三种模式一眼区分模式命令适用场景特点交互式 TUIgh stack view日常开发全屏界面支持鼠标可切换分支紧凑视图gh stack view --short快速扫一眼每个分支一行带状态图标JSON 输出gh stack view --json脚本/CI/AI无交互提示带类型化退出码无论使用哪种模式命令都会先从 GitHub 同步一次 PR 最新状态再展示所以你看到的就是当前真实状态而不是本地缓存的旧数据。默认交互视图分支、提交、PR 一站看全在交互式终端中直接运行gh stack view会打开一个全屏 TUI基于 Alt Screen 渲染支持鼠标操作。它会展示 每个分支在 Stack 中的位置和当前分支高亮 每个分支的最新提交短 SHA、相对时间如 3 days ago和提交标题 分支对应的 PR 链接✅ 状态图标下一节详解在 TUI 中选定某个分支后退出还可以直接把它 checkout 出来省去再敲一次git checkout。在非交互式环境如管道或 CI中命令会自动退化为静态文本输出并通过分页器展示——遵循GIT_PAGER、PAGER环境变量默认less -R。--short 紧凑模式分支状态一行看穿gh stack view --short--short可简写为-s输出紧凑的单行视图是整个命令中信息密度最高的模式。它的结构自上而下是Stack #NStack 编号粗体与 GitHub 界面上的编号一致活跃分支区当前分支以»开头并标注(current)queued分隔线进入合并队列的分支merged分隔线已合并的分支灰色显示└ main底部的 trunk 分支每个分支行后面还跟着彩色 PR 编号绿色开放紫色已合并一眼定位要处理的 PR。状态图标速查四种图标源码定义见 cmd/view.go 的branchStatusIndicator图标含义颜色✓PR 已合并紫色◎PR 已进入合并队列黄色○PR 处于开放状态绿色⚠分支需要 rebase基分支不是其祖先黄色⚠图标尤其值得关注它说明 Stack 历史不线性了此时运行gh stack rebase做级联 rebase 即可恢复。--json 机器可读模式把 Stack 状态喂给脚本和 AIgh stack view --json--json是自动化场景的瑞士军刀 。它有两个关键设计见 cmd/view.go 中runViewJSON永不弹出交互式提示——Agent 和脚本总能拿到干净的机器可读输出返回类型化退出码——脚本可以据此分支处理而不是解析错误文案输出结构固定为三个顶层字段{ trunk: main, currentBranch: feat/02, branches: [ { name: feat/01, head: bbb222, base: aaa111, isCurrent: false, isMerged: true, isQueued: false, needsRebase: false, pr: { number: 42, url: …, state: MERGED } } ] }字段速查表完整字段行为见 cmd/view_test.go 中的断言字段说明trunkStack 底部的 trunk 分支名currentBranch当前所在分支branches[].name/head/base分支名、HEAD 与基分支的 SHAbranches[].isCurrent是否为当前分支branches[].isMerged/isQueuedPR 是否已合并 / 已入合并队列branches[].needsRebase是否需要 rebase已合并分支恒为falsebranches[].pr.stateOPEN/MERGED/QUEUED三选一branches[].pr无 PR 时整个字段省略不会输出null配合jq这类工具哪些分支需要 rebase、栈顶是哪个分支这类问题都变成一行管道命令的事。退出码速查脚本怎么判断结果gh stack view --json用不同退出码区分失败原因便于自动化决策退出码含义建议处理0成功正常解析 JSON1一般错误记录日志2不在任何 Stack 中 / 未找到 Stack提示先gh stack init4GitHub API 调用失败检查认证或稍后重试6需要消歧当前分支属于多个 Stack先 checkout 一个非 trunk 分支再试 退出码6是最容易踩的坑当你在main上、且仓库里存在多个共用该 trunk 的 Stack 时就会触发。切到任意一个具体分支即可消除歧义。实用搭配建议日常开发跑gh stack view看全景跑之前先瞟一眼--short确认没有⚠AI Agent 集成统一使用--json靠退出码做分支判断无需解析彩色文本rebase 后验证gh stack rebase完成后再--json一次确认needsRebase全部归零命令的更多上下文如sync、rebase如何影响 view 展示的状态可在 docs/src/content/docs/reference/cli.md 中查阅。总结gh stack view一个命令、三种形态覆盖了 Stack 状态查看的全部场景需求用哪个看提交、切分支、浏览 PR交互式 TUI终端里快速确认状态--short 四种状态图标脚本 / CI / AI Agent 消费状态--json 退出码掌握它你就随时知道自己的 Stack 走到了哪一步 ✅。【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考