在开始之前
开始前,请确保能登录 GitHub 账户、手边有 iPhone,并准备好安全保存恢复码的位置。企业托管用户(Enterprise Managed Users)通常通过组织的身份提供商登录,请向管理员咨询相应的设置方法。
打开 GitHub 的双重认证设置
- 在浏览器中打开 GitHub 并登录。
- 点击你的个人资料头像,打开设置 (Settings) → 密码和身份验证 (Password and authentication)。
- 选择启用双重认证 (Enable two-factor authentication)。按照下文将账户添加到 Sign In 时,请保持二维码设置页面处于打开状态。
将 GitHub 添加到 Sign In
为了在 iPhone 上获取验证码,我们推荐使用我们的身份验证器应用 Sign In。它会在你的设备上生成验证码。
- 如果 GitHub 的二维码在另一块屏幕上,请在 Sign In 中选择Add → Scan QR Code(添加→扫描二维码)并进行扫描。
- 若要在单台 iPhone 上设置,请在 GitHub 上选择设置密钥 (setup key)。在 Sign In 中,选择Add → Enter Setup Key(添加→输入设置密钥)。输入 GitHub 作为服务 (Service),你的用户名作为账户 (Account),并将密钥粘贴到密钥 (Key) 中。
- 检查详情并点击Add Account(添加账户)。
- 返回 GitHub,使用来自 Sign In 的当前六位验证码进行确认。
- 下载你的恢复码,妥善保管,并确认你已保存它们以完成双重认证的启用。
请对设置密钥保密。仅在 Sign In 中添加账户并不代表 GitHub 的两步验证已启用。
其他支持的方法
在通过身份验证器生成的验证码或短信完成初次设置后,GitHub 还提供其他选项:通行密钥、硬件安全密钥以及GitHub 自带的手机端登录确认。通行密钥和安全密钥提供输入验证码所不具备的网络钓鱼防护能力。
短信仅在支持的国家/地区可用,并可能受到你所在组织的限制。选择备用验证方式时,请考虑短信可能无法送达,以及手机号被盗用的风险。
保存恢复码
将恢复码保存在即使手机丢失也能访问的地方。每个代码仅可使用一次。在设置 (Settings) → 密码和身份验证 (Password and authentication) 中,选择恢复码旁边的查看 (View) 以再次保存它们。生成新的一组代码将使旧的一组失效。
完成设置后,请完成一次带有双重认证的登录,并确认你的备用验证方式可用。避免将所有恢复选项放在同一台设备上。
如果你无法登录,请尝试使用保存的恢复码或先前配置的替代方案。GitHub 的账户恢复说明介绍了其他符合条件的恢复选项。当所有身份验证和恢复选项都丢失时,支持团队无法简单地移除双重认证。
如果验证码被拒绝
- 检查你在 Sign In 中是否选择了正确的 GitHub 用户名。GitHub 不会通过短信发送身份验证器生成的验证码。
- 等待获取新验证码并及时输入,不要带有空格。
- 检查你的 iPhone 日期和时间是否设置为自动获取。
- 如果恢复码失败,请使用最新一组中未使用的代码。先前使用过或已被替换的代码将无法生效。
GitHub 官方帮助
官方文档核对日期:2026 年 10 月 8 日。