嘿，这个需求我之前做教程类工具的时候也碰到过！GitHub API确实没有直接返回指定行内容的端点，但咱们可以用两步操作完美解决，刚好适配你生成动态代码片段的场景。你之前试的Search API其实是用来搜索代码中的关键词、筛选仓库/文件的，并不是用来提取具体行内容的，所以没找到结果很正常～

方法一：用GitHub REST API（最直接） #

这个方法分两步：先获取文件的完整内容，再提取目标行。

步骤1：获取文件内容 #

调用GET /repos/{owner}/{repo}/contents/{path}接口，记得带上分支参数（比如?ref=master）。接口会返回两个关键字段：

• content：文件内容的base64编码字符串
• download_url：文件的原始文本URL

你可以选其中一种方式获取文本：

方式A：解码base64内容

适合不想额外发起一次请求的场景，直接解码接口返回的content字段：

import requests
import base64

# 替换成你的参数
owner = "你的组织/用户名"
repo = "仓库名"
file_path = "文件路径，比如src/main.js"
branch = "master"
start_line = 3  # 你要的起始行（GitHub UI里的行号，1-based）
end_line = 8    # 结束行

# 请求API
api_url = f"https://api.github.com/repos/{owner}/{repo}/contents/{file_path}?ref={branch}"
response = requests.get(api_url)
file_data = response.json()

# 解码base64内容
raw_content = base64.b64decode(file_data["content"]).decode("utf-8")
# 按换行分割成行
all_lines = raw_content.splitlines()

# 提取指定行（注意数组是0-based，所以起始行要减1）
target_snippet = "\n".join(all_lines[start_line-1:end_line])
print(target_snippet)

方式B：直接请求原始文本URL

如果文件比较大，或者不想处理base64，直接用download_url获取原始文本更简单：

# 接着上面的file_data
raw_url = file_data["download_url"]
raw_response = requests.get(raw_url)
raw_content = raw_response.text

all_lines = raw_content.splitlines()
target_snippet = "\n".join(all_lines[start_line-1:end_line])
print(target_snippet)

方法二：用GitHub GraphQL API（更灵活） #

如果你需要同时获取仓库的其他信息（比如文件的提交记录、作者），GraphQL API可以一次性搞定，不过核心还是先获取完整文本再提取行：

示例查询（可以在GitHub的GraphQL Explorer里测试）：

query GetFileSnippet {
  repository(owner: "你的组织/用户名", name: "仓库名") {
    object(expression: "master:文件路径") {
      ... on Blob {
        text
      }
    }
  }
}

拿到text字段后，同样用splitlines()分割，再提取目标行范围即可。

实用提醒 #

• 行号转换：GitHub UI里的#L{Start}-L{End}是1-based的，而代码里的数组索引是0-based，所以一定要记得减1，不然会拿到错误的行！
• 大文件优化：如果要处理非常大的文件，直接加载全部内容可能占内存，这时候可以用流处理（比如Python的requests.get(raw_url, stream=True)），逐行读取直到拿到目标行再停止。
• 私有仓库权限：如果是访问私有仓库，需要在请求头里带上个人访问令牌（PAT）：Authorization: token 你的令牌，令牌需要有repo权限。

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