在 GitHub Desktop 中验证 GitHub

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

平台导航

本文内容

关于身份验证

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

在进行身份验证之前，您必须已在 GitHub.com 上拥有帐户。有关更多信息，请参阅“在 GitHub 上创建帐户”。

验证 GitHub 上的帐户

  1. 在菜单栏中，选择 **GitHub Desktop**，然后单击 **偏好设置**。

    Screenshot of the menu bar on a Mac. Under the open "GitHub Desktop" dropdown menu, the cursor hovers over "Preferences", which is highlighted in blue.

  2. 在“偏好设置”窗口的 **帐户** 面板中，单击“GitHub.com”旁边的 **登录** 按钮。

    Screenshot of the "Accounts" pane in the "Preferences" window. Next to "GitHub.com", a button, labeled "Sign In", is outlined in orange.

  3. 在“使用浏览器登录”模态窗口中，单击 **使用浏览器继续**。GitHub Desktop 将打开您的默认浏览器。

  4. 要验证 GitHub，请在浏览器中输入您的 GitHub.com 凭据，然后单击 **登录**。

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

  5. 如果您已为 GitHub 配置了双重身份验证 (2FA)，请执行以下操作之一

    • 如果您通过短信设置了 2FA，请从短信中获取您的 2FA 代码。
    • 如果您使用 TOTP 应用程序设置了 2FA，请生成一个 2FA 代码。

    然后在 GitHub 上的提示中输入您的 2FA 代码，然后单击 **验证**。

  6. GitHub 验证您的帐户后，请按照提示返回 GitHub Desktop。

验证 GitHub Enterprise Server 上的帐户

  1. 在菜单栏中，选择 **GitHub Desktop**，然后单击 **偏好设置**。

    Screenshot of the menu bar on a Mac. Under the open "GitHub Desktop" dropdown menu, the cursor hovers over "Preferences", which is highlighted in blue.

  2. 在“偏好设置”窗口的 **帐户** 面板中，单击“GitHub Enterprise”旁边的 **登录** 按钮。

    Screenshot of the "Accounts" pane in the "Preferences" window. Next to "GitHub Enterprise", a button, labeled "Sign In", is outlined in orange.

  3. 要在您的 GitHub Enterprise Server 实例上添加帐户，请在“登录”模态窗口中，在“企业地址”下键入实例的 URL，然后单击 **继续**。

  4. 在“使用浏览器登录”模态窗口中，单击 **使用浏览器继续**。GitHub Desktop 将打开您的默认浏览器。

  5. 要验证您的 GitHub Enterprise Server 实例帐户，请输入您的帐户凭据并单击**登录**。

    或者，如果您已登录到您的 GitHub Enterprise Server 实例帐户，请按照提示返回 GitHub Desktop 以完成身份验证。

验证 GitHub 上的帐户

  1. 使用**文件**菜单，然后单击**选项**。

    Screenshot of the "GitHub Desktop" menu bar on Windows. In the expanded "File" dropdown menu, the "Options" item is highlighted with an orange outline.

  2. 在“选项”窗口的**帐户**窗格中，单击“GitHub.com”旁边的**登录**按钮。

    Screenshot of the "Accounts" pane in the "Options" window. Next to "GitHub.com", a button, labeled "Sign In", is outlined in orange.

  3. 在“使用浏览器登录”模态窗口中，单击 **使用浏览器继续**。GitHub Desktop 将打开您的默认浏览器。

    **警告**：不支持使用您的用户名和密码验证 GitHub。我们要求使用浏览器进行身份验证。

  4. 要验证 GitHub，请在浏览器中输入您的 GitHub.com 凭据，然后单击 **登录**。

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

  5. 如果您已为 GitHub 配置了双重身份验证 (2FA)，请执行以下操作之一

    • 如果您通过短信设置了 2FA，请从短信中获取您的 2FA 代码。
    • 如果您使用 TOTP 应用程序设置了 2FA，请生成一个 2FA 代码。

    然后在 GitHub 上的提示中输入您的 2FA 代码，然后单击 **验证**。

  6. GitHub 验证您的帐户后，请按照提示返回 GitHub Desktop。

验证 GitHub Enterprise 上的帐户

  1. 使用**文件**菜单，然后单击**选项**。

    Screenshot of the "GitHub Desktop" menu bar on Windows. In the expanded "File" dropdown menu, the "Options" item is highlighted with an orange outline.

  2. 在“选项”窗口的**帐户**窗格中，单击“GitHub Enterprise”旁边的**登录**按钮。

    Screenshot of the "Accounts" pane in the "Options" window. Next to "GitHub Enterprise", a button, labeled "Sign In", is outlined in orange.

  3. 要添加 GitHub Enterprise 帐户，请在“企业地址”下输入您的凭据，然后单击**继续**。

  4. 如果您已为 GitHub Enterprise 配置了双因素身份验证，请执行以下操作之一

    • 如果您通过短信设置了 2FA，请从短信中获取您的 2FA 代码。
    • 如果您使用 TOTP 应用程序设置了 2FA，请生成一个 2FA 代码。

对身份验证问题进行故障排除

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

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

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

  1. 在菜单栏中，选择**帮助**，然后单击**在 Finder 中显示日志**。

    Screenshot of the "GitHub Desktop" menu bar on a Mac. Under the expanded "Help" dropdown menu, a cursor hovers over "Show Logs in Finder", highlighted in blue.

  2. 从您遇到身份验证错误的日期选择日志文件。

  1. 使用**帮助**下拉菜单并单击**在资源管理器中显示日志**。

    Screenshot of the "GitHub Desktop" menu bar on Windows. In the expanded "Help" dropdown menu, an option labeled "Show Logs in Explorer" is outlined in orange.

  2. 从您遇到身份验证错误的日期选择日志文件。

查看下面针对您遇到的错误消息的故障排除信息。

凭据错误

Error: Bad credentials

此错误表示您的存储帐户凭据存在问题。

要进行故障排除，请注销 GitHub Desktop 上的帐户，然后重新登录。

空令牌

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

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

要进行故障排除，请注销 GitHub Desktop 上的帐户，然后重新登录。

未找到存储库

fatal: repository 'https://github.com/<user>/<repo>.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.)

此错误表示您没有权限访问您尝试克隆的存储库。

要进行故障排除，请联系您组织中管理权限的人员。

无法从远程存储库读取

[email protected]: 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-agent”。

克隆失败

fatal: clone of '[email protected]:<user>/<repo>' into submodule path '<path>' failed
Failed to clone 'src/github.com/<user>/<repo>'. Retry scheduled
Cloning into '<path>'...
[email protected]: 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-agent"。

无法读取 AskPass 响应

error: unable to read askpass response from '/Users/<path>/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 将返回 身份验证失败 错误。要检查这些注册表项是否已被修改，请执行以下步骤。

  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 中创建用户帐户"。

进一步阅读