我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

向 GitHub 验证

您可以通过向 GitHub 验证来安全地访问您的帐户在 GitHub Desktop 上的资源。

本文内容

关于身份验证

为确保帐户安全,必须先进行身份验证,然后才可使用 GitHub Desktop 访问 GitHub上的资源。

在进行身份验证之前,您必须已经有 GitHub 或 GitHub Enterprise 帐户。

  • 有关创建 GitHub 帐户的更多信息,请参阅“注册新 GitHub 帐户”。
  • 对于 GitHub Enterprise 帐户,请联系您的 GitHub Enterprise 网站管理员。

在 GitHub 上验证帐户

  1. 在菜单栏中,使用 GitHub Desktop 下拉菜单,然后单击 Preferences(首选项)

    GitHub Desktop 下拉菜单中的首选项值

  2. 在 Preferences(首选项)窗口中,选择 Accounts(帐户)

    Preferences(首选项)窗口中的 Accounts(帐户) 窗格

  3. 在“GitHub.com”右边单击 Sign In(登录)

    GitHub 的登录按钮

  4. 在“Sign in(登录)”窗格中,单击 Sign in using your browser(使用浏览器登录)。 GitHub Desktop 将打开您的默认浏览器。

    使用浏览器链接登录

    警告:不建议使用用户名和密码向 GitHub 验证。 我们建议使用浏览器进行身份验证。

  5. 要验证 GitHub,请输入您的 GitHub.com 凭据,然后单击 Sign in(登录)

    浏览器中 GitHub 的登录按钮

    或者,如果您已登录 GitHub,请按照提示返回 GitHub Desktop 完成身份验证。

  6. 如果已为 GitHub 配置双重身份验证 (2FA),请执行以下操作之一:

    • 如果通过 SMS 设置 2FA,则从 SMS 消息检索 2FA 代码 。
    • 如果使用 TOTP 应用程序设置 2FA,则生成 2FA 代码。

    然后在 GitHub 上出现提示时输入 2FA 码,再单击 Verify(验证)

    2FA 验证码字段

  7. 在 GitHub 验证帐户后,按照提示返回到 GitHub Desktop。

在 GitHub Enterprise 上验证帐户

警告:不建议使用用户名和密码向 GitHub 验证。 我们建议使用浏览器进行身份验证。

  1. 在菜单栏中,使用 GitHub Desktop 下拉菜单,然后单击 Preferences(首选项)

    GitHub Desktop 下拉菜单中的首选项值

  2. 在 Preferences(首选项)窗口中,选择 Accounts(帐户)

    Preferences(首选项)窗口中的 Accounts(帐户) 窗格

  3. 在“GitHub Enterprise Server”右边单击 Sign In(登录)

    GitHub Enterprise Server 的 Sign in(登录)按钮

  4. 要添加 GitHub Enterprise 帐户,请在“Enterprise server address(企业服务器地址)”下键入您的凭据,然后单击 Continue(继续)

    GitHub Enterprise 的登录按钮

  5. 如果已为 GitHub Enterprise 配置双重身份验证,请执行以下操作之一:

    • 如果通过 SMS 设置 2FA,则从 SMS 消息检索 2FA 代码 。
    • 如果使用 TOTP 应用程序设置 2FA,则生成 2FA 代码。

    然后在 GitHub Desktop 上出现提示时输入 2FA 码,再单击 Sign In(登录)

    2FA 验证码字段

在 GitHub 上验证帐户

  1. 使用 File(文件)菜单,然后单击 Options(选项)

    Settings(设置)下拉菜单中的 Options(选项)值

  2. 在 Options(选项)窗口中,选择 Accounts(帐户)

    Options(选项)窗口中的 Accounts(帐户)窗格

  3. 在 "GitHub.com" 右边单击 Sign in(登录)

    GitHub 的登录按钮

  4. 在 Sign in(登录)窗格中,单击 Sign in using your browser(使用浏览器登录)

    使用浏览器链接登录

    警告:不建议使用用户名和密码向 GitHub 验证。 我们建议使用浏览器进行身份验证。

  5. 要验证 GitHub,请输入您的 GitHub.com 凭据,然后单击 Sign in(登录)

    浏览器中 GitHub 的登录按钮

    或者,如果您已登录 GitHub,请按照提示返回 GitHub Desktop 完成身份验证。

  6. 如果已为 GitHub 配置双重身份验证 (2FA),请执行以下操作之一:

    • 如果通过 SMS 设置 2FA,则从 SMS 消息检索 2FA 代码 。
    • 如果使用 TOTP 应用程序设置 2FA,则生成 2FA 代码。

    然后在 GitHub 上出现提示时输入 2FA 码,再单击 Verify(验证)

    2FA 验证码字段

  7. 在 GitHub 验证帐户后,按照提示返回到 GitHub Desktop。

在 GitHub Enterprise 上验证帐户

警告:不建议使用用户名和密码向 GitHub 验证。 我们建议使用浏览器进行身份验证。

  1. 使用 File(文件)菜单,然后单击 Options(选项)

    Settings(设置)下拉菜单中的 Options(选项)值

  2. 在 Options(选项)窗口中,选择 Accounts(帐户)

    Options(选项)窗口中的 Accounts(帐户)窗格

  3. 在“GitHub Enterprise Server”右边单击 Sign In(登录)

    GitHub Enterprise Server 的 Sign in(登录)按钮

  4. 要添加 GitHub Enterprise 帐户,请在“Enterprise server address(企业服务器地址)”下键入您的凭据,然后单击 Continue(继续)

    GitHub Enterprise 的登录按钮

  5. 如果已为 GitHub Enterprise 配置双重身份验证,请执行以下操作之一:

    • 如果通过 SMS 设置 2FA,则从 SMS 消息检索 2FA 代码 。
    • 如果使用 TOTP 应用程序设置 2FA,则生成 2FA 代码。

    然后在 GitHub Desktop 上出现提示时输入 2FA 码,再单击 Sign In(登录)

    2FA 验证码字段

解决身份验证问题

如果 GitHub Desktop 遇到身份验证错误,可以使用错误消息进行故障排除。

如果您遇到身份验证错误,请先尝试在 GitHub Desktop 上注销您的帐户,然后重新登录。

对于某些错误,GitHub Desktop 会以错误消息提示您。 如果没有提示,或者要查找任何错误的更多信息,请使用以下步骤查看 GitHub Desktop 日志文件。

  1. 使用 Help(帮助)下拉菜单并单击 Show Logs in Finder(在 Finder 中显示日志)
    Show Logs in Finder(在 Finder 中显示日志)按钮
  2. 选择您遇到身份验证错误之日的日志文件。
  1. 使用 Help(帮助)下拉菜单并单击 Show Logs in Explorer(在 Explorer 中显示日志)
    Show Logs in Explorer(在 Explorer 中显示日志)按钮
  2. 选择您遇到身份验证错误之日的日志文件。

查看下面的故障排除信息,了解您遇到的错误消息。

无效凭据

Error: Bad credentials

此错误意味着存储的帐户凭据有问题。

要解决问题,请在 GitHub Desktop 上注销您的帐户,然后重新登录。

空令牌

info: [ui] [AppStore.withAuthenticatingUser] account found for repository: node -  (empty token)

这个错误表示 GitHub Desktop 找不到它在系统密钥链中创建的访问令牌。

要解决问题,请在 GitHub Desktop 上注销您的帐户,然后重新登录。

未找到仓库

fatal: repository 'https://github.com//.git' not found

(The error was parsed as 8: The repository does not seem to exist anymore. You may not have access, or it may have been deleted or renamed.)

这个错误表示您没有权限访问您想克隆的仓库。

要解决问题,请联系您组织中管理权限的人。

无法读取远程仓库

git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

这个错误表示您没有设置有效的 SSH 密钥。

要解决问题,请参阅“生成新的 SSH 密钥并添加到 SSH 代理”。

无法克隆

fatal: clone of 'git@github.com:/' into submodule path '' failed
Failed to clone 'src/github.com//'. Retry scheduled
Cloning into ''...
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

这个错误表示您尝试克隆的仓库包含您无法访问的子模块,或者您没有设置有效的 SSH 密钥。

如果您无法访问子模块,请通过联系管理仓库权限的人解决问题。

如果未设置有效的 SSH 密钥,请参阅“生成新的 SSH 密钥并添加到 SSH 代理”。

无法读取 AskPass 响应

error: unable to read askpass response from '/Users//GitHub Desktop.app/Contents/Resources/app/static/ask-pass-trampoline.sh'
fatal: could not read Username for 'https://github.com': terminal prompts disabled

这个错误可能是多个事件造成的。

如果 Command Processor 注册表条目已修改,GitHub Desktop 将以 Authentication failed 错误响应。 要检查这些注册表条目是否已修改,请按照以下步骤操作。

  1. 打开注册表编辑器 (regedit.exe) 并导航到以下位置。 HKEY_CURRENT_USER\Software\Microsoft\Command Processor\`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor`
  2. 检查任一位置是否有 Autorun 值。
  3. 如果有 Autorun 值,请删除它。

如果您的 Windows 用户名延长了 Unicode 字符,可能导致 AskPass 响应错误。 要解决问题,请创建新的 Windows 用户帐户,然后将文件迁移到该帐户。 更多信息请参阅 Microsoft 文档中的 "在 Windows 中创建用户帐户"。

延伸阅读

此文档对您有帮助吗?

Privacy policy

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。