如何用GraphQL查询GitLab特定分支的历史提交记录？

• 完全可以通过GraphQL查询特定分支的提交历史，不需要依赖REST API。
• 你之前的查询仅调用了lastCommit，要获取完整提交列表，需使用repository下的commits字段，并指定目标分支的refName参数。

示例查询代码 #

{
  project(fullPath: "group-name/project-name") {
    repository {
      # 指定目标分支，格式为 refs/heads/分支名
      commits(refName: "refs/heads/main", limit: 20, orderBy: {field: COMMIT_DATE, direction: DESC}) {
        nodes {
          title
          authorName
          committedDate
          sha
          message
        }
      }
    }
  }
}

关键参数说明 #

• refName: 必填项，需按refs/heads/分支名格式指定目标分支（比如refs/heads/dev）
• limit: 可选项，控制返回的提交数量，需符合GitLab GraphQL的数量限制规则
• orderBy: 可选项，支持按提交日期、作者等字段排序，方向可选升序或降序

可自定义的返回字段 #

示例中的返回字段可按需调整，常用字段还包括：

• authorEmail: 提交作者邮箱
• committerName: 提交者名称
• webUrl: 提交在GitLab平台的网页地址

内容的提问来源于stack exchange，提问作者Davis Dong