GitHub CLI 中查看 PR 提交信息的完整解决方案

GitHub CLI（gh）是开发者日常工作中不可或缺的工具，它提供了丰富的命令行接口来管理 GitHub 上的各种资源。其中，gh pr view 命令是查看 Pull Request 详情的常用方式，而通过 --json 参数可以获取结构化的数据输出。

在实际开发中，我们经常需要获取 PR 中提交的完整 commit 信息，包括提交标题和详细描述。GitHub CLI 的 gh pr view --json commits 命令虽然提供了基本的提交信息，但默认情况下存在一些限制：

1. 提交信息被分割为 messageHeadline 和 messageBody 两个字段
2. 当提交信息较长时，messageHeadline 会被截断并以省略号结尾
3. messageBody 字段在 messageHeadline 被截断时会以省略号开头

这种设计虽然节省了空间，但对于需要完整提交信息的自动化脚本或工具来说不够友好。开发者可以通过以下两种方式解决这个问题：

方法一：使用 GraphQL API 直接查询

通过 GitHub 的 GraphQL API，我们可以获取完整的提交信息：

query GetPRCommits($owner: String!, $repo: String!, $prNumber: Int!) {
  repository(owner: $owner, name: $repo) {
    pullRequest(number: $prNumber) {
      commits(first: 100) {
        nodes {
          commit {
            oid
            message
            author {
              name
              email
            }
          }
        }
      }
    }
  }
}

这个查询会返回完整的提交信息，包括提交哈希和作者信息，适合需要高度定制化查询的场景。

方法二：组合现有字段

对于简单的使用场景，可以通过组合 messageHeadline 和 messageBody 来重建完整的提交信息：

gh pr view <PR号> --json commits | jq '.commits[] | {
  oid,
  fullMessage: (.messageHeadline + (.messageBody | if . != "" then "\n" + . else "" end))
}'

这个命令使用 jq 工具将两个字段合并，并在需要时添加换行符，生成完整的提交信息。

最佳实践建议

1. 对于自动化脚本，建议使用 GraphQL API 获取完整数据
2. 对于交互式使用，可以创建自定义的 shell 函数或别名来简化操作
3. 注意 GitHub API 的分页限制，大型 PR 可能需要多次查询
4. 考虑将常用查询保存为模板，提高工作效率

GitHub CLI 团队也在持续改进这些功能，未来版本可能会提供更便捷的方式来获取完整的提交信息。开发者可以根据自己的需求选择最适合的解决方案，提高日常开发效率。