关于支持的操作系统
GitHub Desktop 支持以下操作系统。
- macOS 10.15 或更高版本
- Windows 10 64 位或更高版本。运行 GitHub Desktop 必须使用 64 位操作系统。
macOS 上的问题排查
如果你在 macOS 上使用 GitHub Desktop 时遇到问题,请尝试以下解决方案。更多信息,请参阅 known-issues。
登录帐户后出现输入的用户名或密码不正确错误
当 GitHub Desktop 无法访问 Keychain 中存储的凭据时,可能会出现此错误。
要解决此错误,请按照以下步骤操作。
- 打开“钥匙串访问”应用程序。
- 在左侧边栏的钥匙串列表中,右键单击**登录**,然后单击**锁定钥匙串“登录”**。
- 右键单击**登录**,然后单击**解锁钥匙串“登录”**。按照屏幕上的提示完成解锁钥匙串“登录”。
- 在 GitHub 或 GitHub Enterprise 上重新验证你的帐户。
检查更新后出现无法创建临时目录:权限被拒绝错误
此错误可能是由于~/Library/Caches/com.github.GitHubClient.ShipIt目录缺少权限导致的。GitHub Desktop 使用此目录在更新应用程序的过程中创建和解压临时文件。
要解决此错误,请按照以下步骤操作。
- 关闭 GitHub Desktop。
- 打开“Finder”并导航到
~/Library/Caches/。 - 右键单击
com.github.GitHubClient.ShipIt,然后单击**显示简介**。 - 单击“共享与权限”左侧的箭头。
- 如果你的用户帐户右侧的权限不是“读与写”,请单击该文本,然后单击**读与写**。

- 打开 GitHub Desktop 并检查更新。
Windows 上的问题排查
如果你在 Windows 上使用 GitHub Desktop 时遇到问题,请尝试以下解决方案。更多信息,请参阅 known-issues。
撤销功能无法检查证书的撤销状态。错误
如果在阻止 Windows 检查证书撤销状态的企业网络上使用 GitHub Desktop,则可能会出现此错误。
要进行故障排除,请联系你的系统管理员。
使用配置了文件夹重定向的仓库时出现git clone 失败错误
GitHub Desktop 不支持配置了文件夹重定向的仓库。
检测到 cygheap 基址不匹配错误
启用强制 ASLR 时可能会出现此错误。启用强制 ASLR 会影响 MSYS2 核心库,而 GitHub Desktop 依赖此库来模拟进程分叉。
要解决此错误,请禁用强制 ASLR 或显式允许依赖 MSYS2 的<Git>\usr\bin下所有可执行文件。
此操作系统不再受支持。软件更新已被禁用通知
如果你运行的是不再与 GitHub Desktop 兼容的 Windows 版本,则会显示此通知。GitHub Desktop 支持 Windows 10 64 位或更高版本。如果你正在运行受支持的 Windows 操作系统但仍然看到此通知,这可能是因为已为 GitHub Desktop 启用了兼容性模式。要检查是否启用了兼容性模式,请按照以下步骤操作。
- 打开 Windows **开始菜单**。
- 搜索“GitHub Desktop”。
- 选择并按住(或右键单击)**GitHub Desktop**,然后单击**打开文件位置**。
- 选择并按住(或右键单击)GitHub Desktop 快捷方式,然后单击**属性**。
- 选择**兼容性**选项卡。
- 在“兼容性模式”部分,确保取消选中**以兼容模式运行此程序**复选框。