GitHub 启用双因素身份验证(2FA)配置指南
如果你最近登录 GitHub 时被提示'启用双因素身份验证(2FA)',别慌——这其实是在密码之外增加的一道'动态验证码'安全锁。下面用 TOTP 类工具带你从 0 到 1 完成配置,按步骤操作即可。
一、找到开启入口
当 GitHub 弹出启用 2FA 提示时,点击 启用 2FA 进入设置流程。

二、核心流程概览
- 准备工具:使用 TOTP 应用(如 TOTP.app 或 Google Authenticator)。
- 获取密钥:在 GitHub 页面复制 Setup key 或扫描二维码。
- 绑定验证器:将密钥填入工具生成 6 位验证码。
- 确认绑定:将验证码填回 GitHub 完成激活。
- 异常处理:若验证失败,刷新页面重新获取新密钥重试。
三、配置 TOTP 应用
搜索并打开你的 TOTP 工具,点击 新建 创建条目。

创建时有两项关键信息:
- App name:随意填写,建议设为
GitHub方便识别。 - 密钥(Secret):必须来自 GitHub 的设置页面。
注意:如果二维码无法扫描,直接复制文本形式的 Setup key 手动输入即可。
四、获取 GitHub 密钥
回到 GitHub 的 2FA 认证页面,你会看到 Key / Setup key。将其完整复制下来。

五、生成动态验证码
- 回到 TOTP 应用的新建页面。
- 将刚才复制的 Setup key 粘贴到 密钥/Secret 栏。
- 保存后,应用会开始滚动生成 6 位验证码(通常每 30 秒刷新一次)。
添加完成后读取验证码,如图所示:

六、完成绑定
将 TOTP 生成的 6 位验证码填入 GitHub 的 code 输入框,继续下一步确认即可。

七、常见问题排查
如果提示'验证码不对'或验证失败,请尝试以下操作(最有效):
- 刷新 GitHub 设置页面。
- 重新获取一个新的 Setup key。
- 在 TOTP 应用中删除旧条目,用新密钥重新新建。
- 再次提交新的 6 位验证码。
重点:不要一直用旧的 setup key 硬试。GitHub 刷新后密钥可能已变,必须按新 key 重走一遍流程。
八、后续建议
2FA 开启后,为了更安全,别忘了做这两件事:
- 规范命名:把 TOTP 条目命名为
GitHub或GitHub-main,避免以后找不到。 - 备份恢复码:如果页面提示有 Recovery codes 或备用验证方式,建议保存到安全位置(如密码管理器),防止手机丢失后无法登录。
按照以上步骤,你就能顺利完成 GitHub 2FA 配置。

