关于认证
为了保证帐户安全，在使用 GitHub Desktop 访问 GitHub 上的资源之前，你必须进行认证。
在进行认证之前，你必须已经在 GitHub.com 上拥有一个帐户。更多信息，请参阅“在 GitHub 上创建帐户”。
在 GitHub 上认证帐户
-
在菜单栏中，选择GitHub Desktop，然后单击首选项。
-
在“首选项”窗口中，在帐户窗格上，单击“GitHub.com”旁边的登录按钮。
-
在“使用浏览器登录”模态窗口中，单击使用浏览器继续。GitHub Desktop 将打开你的默认浏览器。
-
要在浏览器中向 GitHub 认证，请键入你的 GitHub.com 凭据并单击登录。
或者，如果你已登录 GitHub，请按照提示返回 GitHub Desktop 完成认证。
-
如果你已为 GitHub 配置了双重身份验证 (2FA)，请执行以下操作之一
- 如果你通过短信设置了 2FA，请从短信消息中获取你的 2FA 代码。
- 如果你使用 TOTP 应用程序设置了 2FA，请生成一个 2FA 代码。
然后在 GitHub 上的提示中输入你的 2FA 代码并单击验证。
-
在 GitHub 认证你的帐户后，请按照提示返回 GitHub Desktop。
在 GitHub Enterprise Server 上认证帐户
-
在菜单栏中，选择GitHub Desktop，然后单击首选项。
-
在“首选项”窗口中，在帐户窗格上，单击“GitHub Enterprise”旁边的登录按钮。
-
要在你的 GitHub Enterprise Server 实例上添加帐户，请在“登录”模态窗口中，在“企业地址”下键入你的实例的 URL，然后单击继续。
-
在“使用浏览器登录”模态窗口中，单击使用浏览器继续。GitHub Desktop 将打开你的默认浏览器。
-
要向你的 GitHub Enterprise Server 实例帐户认证，请键入你的帐户凭据并单击登录。
或者，如果您已登录到 GitHub Enterprise Server 实例帐户，请按照提示返回 GitHub Desktop 完成身份验证。
在 GitHub 上认证帐户
-
使用文件菜单，然后单击选项。
-
在“选项”窗口的帐户窗格中，单击“GitHub.com”旁边的登录按钮。
-
在“使用浏览器登录”模态窗口中，单击使用浏览器继续。GitHub Desktop 将打开你的默认浏览器。
警告：不支持使用用户名和密码对 GitHub 进行身份验证。我们需要使用浏览器进行身份验证。
-
要在浏览器中向 GitHub 认证，请键入你的 GitHub.com 凭据并单击登录。
或者，如果你已登录 GitHub，请按照提示返回 GitHub Desktop 完成认证。
-
如果你已为 GitHub 配置了双重身份验证 (2FA)，请执行以下操作之一
- 如果你通过短信设置了 2FA，请从短信消息中获取你的 2FA 代码。
- 如果你使用 TOTP 应用程序设置了 2FA，请生成一个 2FA 代码。
然后在 GitHub 上的提示中输入你的 2FA 代码并单击验证。
-
在 GitHub 认证你的帐户后，请按照提示返回 GitHub Desktop。
在 GitHub Enterprise 上验证帐户
-
使用文件菜单，然后单击选项。
-
在“选项”窗口的帐户窗格中，单击“GitHub Enterprise”旁边的登录按钮。
-
要添加 GitHub Enterprise 帐户，请在“企业地址”下键入您的凭据，然后单击继续。
-
如果您已为 GitHub Enterprise 配置了两因素身份验证，请执行以下操作之一
- 如果你通过短信设置了 2FA，请从短信消息中获取你的 2FA 代码。
- 如果你使用 TOTP 应用程序设置了 2FA，请生成一个 2FA 代码。
身份验证问题故障排除
如果 GitHub Desktop 遇到身份验证错误，您可以使用错误消息进行故障排除。
如果您遇到身份验证错误，请首先尝试在 GitHub Desktop 上退出并重新登录您的帐户。
对于某些错误，GitHub Desktop 会提示您输入错误消息。如果您没有收到提示，或要查找有关任何错误的更多信息，请使用以下步骤查看 GitHub Desktop 日志文件。
-
在菜单栏中，选择帮助，然后单击在 Finder 中显示日志。
-
从遇到身份验证错误的日期中选择日志文件。
-
使用帮助下拉菜单并单击在资源管理器中显示日志。
-
从遇到身份验证错误的日期中选择日志文件。
查看您遇到的错误消息的故障排除信息。
错误的凭据
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 将响应 Authentication failed 错误。要检查是否修改了这些注册表项，请按照以下步骤操作。
- 打开注册表编辑器 (
regedit.exe) 并导航到以下位置。HKEY_CURRENT_USER\Software\Microsoft\Command Processor\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\ - 检查任一位置中是否存在
Autorun值。 - 如果存在
Autorun值，请将其删除。
如果你的 Windows 用户名有扩展的 Unicode 字符，则可能导致 AskPass 响应错误。要进行故障排除，请创建一个新的 Windows 用户帐户并将你的文件迁移到该帐户。有关详细信息，请参阅 Microsoft 文档中的“在 Windows 中创建用户帐户”。