GitHub API 默认不返回用户邮箱，即使使用有效 Token，也仅当用户主动公开邮箱且 Token 拥有 user:email 权限时才可能获取；直接调用 user.email 字段常返回 None，需改用 /user/emails 端点并显式请求。
github api 默认不返回用户邮箱，即使使用有效 token，也仅当用户主动公开邮箱且 token 拥有 `user:email` 权限时才可能获取；直接调用 `user.email` 字段常返回 `none`，需改用 `/user/emails` 端点并显式请求。
在 GitHub 生态中，用户邮箱地址属于敏感隐私数据，API 设计严格遵循最小权限与隐私保护原则。默认情况下，无论是通过 GET /users/{username}（即 g.get_user()）还是 Issue 相关资源，email 字段均不会返回真实值——即使用户存在、Token 有效，结果也几乎总是 None 或空字符串。
✅ 正确做法：使用 /user/emails 端点 + 显式权限
要获取当前认证用户自身的邮箱（例如用于审计或通知），必须：
- 确保 Personal Access Token 已授权 user:email 范围（在 GitHub Settings → Developer settings → Personal access tokens 中勾选）；
- 调用 GET /user/emails 接口（对应 PyGithub 的 g.get_user().get_emails()），该接口返回用户所有已验证邮箱列表，并标注主邮箱（primary: true）和可见性（visibility: 'public' | 'private' | 'limited'）；
- 注意：此接口仅返回 当前 Token 所属用户 的邮箱，无法跨账户获取他人邮箱（GitHub 明确禁止）。
以下为修正后的 Python 示例（基于 PyGithub>=1.57）：
from github import Github
from typing import List, Dict, Optional
def extract_issues_with_emails(repo_url: str, access_token: str) -> Optional[List[Dict]]:
try:
g = Github(access_token)
# 解析仓库路径
repo_path = repo_url.strip('/').split('/')[-2:]
if len(repo_path) < 2:
raise ValueError("Invalid repository URL format")
username, repo_name = repo_path
repo = g.get_repo(f"{username}/{repo_name}")
issues_data = []
for issue in repo.get_issues(state='all'):
# ✅ 获取 issue 创建者邮箱（仅限当前 Token 用户自身）
opener_email = None
if issue.user and issue.user.login == g.get_user().login:
try:
emails = g.get_user().get_emails()
primary_email = next((e.email for e in emails if e.primary), None)
opener_email = primary_email
except Exception as e:
print(f"Failed to fetch emails for {issue.user.login}: {e}")
# ❌ closed_by.email 不可用（GitHub 不提供该字段）
# ✅ 替代方案：若关闭者 = 当前用户，则同上获取；否则视为不可获取
closer_email = None
if issue.closed_by and issue.closed_by.login == g.get_user().login:
try:
emails = g.get_user().get_emails()
primary_email = next((e.email for e in emails if e.primary), None)
closer_email = primary_email
except Exception as e:
print(f"Failed to fetch emails for closer {issue.closed_by.login}: {e}")
issues_data.append({
'id': issue.number,
'title': issue.title,
'description': issue.body,
'state': issue.state,
'created_at': issue.created_at.strftime('%Y-%m-%d %H:%M:%S'),
'closed_at': issue.closed_at.strftime('%Y-%m-%d %H:%M:%S') if issue.closed_at else None,
'opened_by': issue.user.login if issue.user else None,
'opener_mail': opener_email,
'closed_by': issue.closed_by.login if issue.closed_by else None,
'closer_mail': closer_email,
'comments_count': issue.comments
})
return issues_data
except Exception as e:
print(f"An error occurred: {str(e)}")
return None⚠️ 关键注意事项
- 无法获取他人邮箱：GitHub API 明确禁止通过任何方式（包括 Issue、PR、Commit、User API）获取非当前认证用户的邮箱。这是平台强制策略，与 Token 权限无关。
- user:email 权限仅作用于自身：该 scope 仅允许读取 你自己的 邮箱列表，不赋予跨账户访问能力。
- 公开邮箱 ≠ API 可见：即使用户在个人资料页设置了“Public email”，GitHub 仍可能因隐私设置（如 “Keep my email address private”）阻止 API 返回。
-
合规建议：
- 若业务需联系贡献者，请优先使用 GitHub 的 @mention 或 Issue/PR 评论机制；
- 如需批量通信，应引导用户主动订阅或通过组织级 OAuth App 获取明确授权；
- 切勿尝试爬虫、伪造请求或滥用 API 绕过限制——违反 GitHub API Terms 可能导致 Token 封禁或账户终止。
简言之：你能安全、合法获取的邮箱，仅限于你自己的已验证邮箱；所有关于“提取他人邮箱”的需求，在 GitHub 平台上本质上是不可行且不被支持的。
