用PyGithub轻松操控GitHub（Python初学者也能上手的GitHub API实战教程）

什么是 PyGithub？

PyGithub 是一个用于访问 GitHub API 的 Python 封装库。它让你无需手动构造 HTTP 请求，就能以面向对象的方式操作 GitHub 上的资源，比如用户、仓库、分支、Pull Requests、Issues 等。

准备工作

在开始之前，请确保你已经安装了 Python（建议 3.6+），并完成以下步骤：

1. 安装 PyGithub 库：
   pip install PyGithub
2. 在 GitHub 上生成一个 Personal Access Token（个人访问令牌）：
   - 登录 GitHub
   - 点击右上角头像 → Settings → Developer settings → Personal access tokens → Tokens (classic)
   - 点击 “Generate new token” → 选择所需权限（如 repo、user 等）→ 生成并复制令牌
   注意：请妥善保管该令牌，不要泄露！

第一个 PyGithub 程序：获取用户信息

下面是一个简单的例子，展示如何使用你的 Token 获取 GitHub 用户的基本信息：

from github import Github# 使用你的 Personal Access TokenTOKEN = "your_personal_access_token_here"g = Github(TOKEN)# 获取当前认证用户的信息user = g.get_user()print(f"用户名: {user.login}")print(f"公开仓库数: {user.public_repos}")print(f"粉丝数: {user.followers}")

运行这段代码后，你会看到类似以下的输出：

用户名: your_github_username公开仓库数: 42粉丝数: 15

实战：列出某个仓库的所有 Issues

接下来，我们尝试获取一个公开仓库中的所有 Issues。例如，获取官方 requests 库的未关闭 Issues：

from github import GithubTOKEN = "your_personal_access_token_here"g = Github(TOKEN)# 获取指定仓库repo = g.get_repo("psf/requests")# 获取所有未关闭的 Issuesissues = repo.get_issues(state='open')for issue in issues[:5]:  # 只打印前5个    print(f"#{issue.number}: {issue.title}")    print(f"由 @{issue.user.login} 创建于 {issue.created_at}\n")

更多应用场景

掌握了基础用法后，你可以用 PyGithub 实现许多自动化任务，例如：

• 自动创建 Issue 或 Pull Request
• 批量更新仓库描述或标签
• 监控仓库活动并发送通知
• 备份你的所有仓库信息

安全提示

永远不要将你的 Personal Access Token 硬编码在代码中，尤其是在上传到 GitHub 时！推荐使用环境变量或配置文件（并加入 .gitignore）来管理敏感信息：

import osfrom github import GithubTOKEN = os.getenv('GITHUB_TOKEN')  # 从环境变量读取g = Github(TOKEN)

总结

通过本教程，你已经学会了如何使用 PyGithub 调用 GitHub API 来自动化管理你的 GitHub 资源。无论你是想提升开发效率，还是构建自己的 DevOps 工具链，掌握这项技能都非常有价值。赶快动手试试吧！

关键词回顾：PyGithub、GitHub API、Python操作GitHub、自动化GitHub管理