如何在单条GitHub GraphQL查询中使用仓库默认分支而非硬编码master？

当然可以做到！GitHub GraphQL API允许你在同一个查询中嵌套获取仓库的默认分支信息，以及该分支下指定文件的内容，完全不需要分两次请求。

核心思路是利用GraphQL的嵌套查询能力：先定位到目标仓库，获取它的defaultBranchRef（默认分支引用），然后从这个引用里同时拿到分支名称，以及该分支指向的Commit对象，进而查询对应路径的文件内容。

这里有一个完整的查询示例：

query GetDefaultBranchFileContent($owner: String!, $repo: String!, $path: String!) {
  repository(owner: $owner, name: $repo) {
    defaultBranchRef {
      # 获取默认分支的名称（比如main、master）
      name
      target {
        # 分支指向的是Commit类型，所以需要用片段进行类型转换
        ... on Commit {
          file(path: $path) {
            name
            text # 文件的文本内容，如果是二进制文件可以用downloadUrl
          }
        }
      }
    }
  }
}

你只需要传入三个变量：

• $owner: 仓库所有者的用户名或组织名
• $repo: 仓库的名称
• $path: 你要查询的文件相对路径（比如README.md）

这个查询会一次性返回：

1. 仓库的默认分支名称
2. 该分支下指定文件的名称和文本内容

这样就彻底摆脱了硬编码分支名的问题，而且完全不需要额外的查询请求。如果仓库后续修改了默认分支，这个查询也能自动适配，非常灵活。

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