用途:当用户要求在不合并的情况下关闭 PR,或 PR 已被放弃、被其他 PR 取代、不再需要、需要清理陈旧 PR 时使用。
主要能力:通过 GitHub CLI(gh)关闭指定 PR,可附加关闭评论,并可在关闭后删除关联分支。参数支持 PR 编号、URL 或分支名;非当前仓库时可用 --repo OWNER/REPO 指定目标仓库。
使用方式:先确认认证状态,执行 gh --version 与 gh auth status;关闭前查看 PR 状态,如 gh pr view 123 --json number,title,state,headRefName;然后关闭,例如 gh pr close 123、gh pr close 123 --comment "Closing: superseded by #456"、gh pr close 123 --delete-branch;最后验证,如 gh pr view 123 --json state,closedAt。
常用标志:-c, --comment 留下关闭评论;-d, --delete-branch 关闭后删除本地与远程分支。
限制与注意:关闭的 PR 可用 gh pr reopen 重新打开;使用 --delete-branch 会清理功能分支;需先确认是否删除关联分支、是否添加关闭评论以及目标仓库。参考资料为 GitHub CLI 手册 https://cli.github.com/manual/ 与 gh pr close --help。