将 GitHub 帐户添加到 Visual Studio 密钥链

本文介绍如何将公共 GitHub 或 GitHub Enterprise 帐户添加到 Visual Studio 密钥链。 添加帐户后,可以直接从 Visual Studio 跟踪 GitHub 存储库中的代码更改。 还可以创建和使用 GitHub Actions 进行部署自动化

添加公共 GitHub 帐户

使用 Microsoft 帐户、工作帐户或学校帐户登录到 Visual Studio 后,便可随时添加公共 GitHub 帐户。

本文介绍如何将公共 GitHub 或 GitHub Enterprise 帐户添加到 Visual Studio 密钥链。 添加帐户后,可以直接从 Visual Studio 使用 GitHub Copilot跟踪 GitHub 存储库中的代码更改。 还可以创建和使用 GitHub Actions 进行部署自动化

添加公共 GitHub 帐户

可以在首次启动或更高版本时添加公共 GitHub 帐户,而无需 使用Microsoft帐户、工作帐户或学校帐户登录到 Visual Studio。 可以将多个 GitHub 帐户添加到 IDE。 添加的第一个帐户将成为 活动 帐户,但可以随时将活动帐户切换到另一个帐户。 添加多个 GitHub 帐户会影响 Copilot 和版本控制方案,以及 Visual Studio 中的常规 GitHub 身份验证体验。

如果已安装 GitHub Copilot,则可以通过从 GitHub Copilot 状态图标选择“登录”以使用 Copilot 或从聊天窗口中注册 Copilot Free 来添加包含 Copilot 订阅的 GitHub 帐户,即使尚未使用Microsoft帐户、工作帐户或学校帐户登录到 Visual Studio

首次启动时添加 GitHub 帐户

使用 Visual Studio 17.13 或更高版本,现在可以 首次启动 Visual Studio 时使用 GitHub 帐户登录。

显示 Visual Studio 首次启动时登录的屏幕截图。

如果使用没有有效 GitHub Copilot 订阅的 GitHub 帐户登录,可以选择在首次使用 Visual Studio 17.14 或更高版本启动时 激活 Copilot 免费版,或者稍后在 IDE 或聊天窗口中的 GitHub Copilot 徽章处 注册

如果 管理员禁用 Copilot,则第一次启动体验会遵循组策略。

如果选择在首次启动时未使用 GitHub 登录,则可以稍后使用 个人资料卡帐户设置 对话框添加 GitHub 帐户,如下所示。

个人资料卡片添加 GitHub 帐户

选择 Visual Studio 环境右上角的 “登录 ”链接,然后使用 Microsoft帐户、工作帐户或学校帐户或 GitHub 帐户登录。

显示 Visual Studio 中的个人资料卡的屏幕截图。

然后,按照这些说明添加 GitHub 帐户。

  1. 在 Visual Studio 环境的右上角选择您的配置文件名称的图标,如果尚未登录,请选择 GitHub添加其他帐户,然后选择 GitHub

    在用户资料设置中使用“添加另一个帐户”选项添加 GitHub 帐户的屏幕截图。

  2. 你将重定向到浏览器,你可以在其中使用 GitHub 凭据登录。 登录后,会在浏览器中获得成功窗口,并可以返回到 Visual Studio。

  3. 你添加的 GitHub 帐户现在会显示在个人资料卡中。 请注意,你首先登录的帐户是 活动 帐户。

    显示登录配置文件上的两个帐户的屏幕截图。

“帐户设置” 对话框添加 GitHub 帐户

  1. 通过转到 文件>帐户设置...打开“帐户设置”对话框。

  2. 所有帐户 子菜单中,选择 + 添加 以添加帐户,然后选择 GitHub

    选择添加 GitHub 帐户

  3. 你将重定向到浏览器,你可以在其中使用 GitHub 凭据登录。 登录后,会在浏览器中获得成功窗口,并可以返回到 Visual Studio。

    浏览器浏览器中的“成功”窗口Success window in browserSuccess window in browser中的“成功”窗口

  4. GitHub 帐户现在会显示在 所有帐户 子菜单中。

    显示两个帐户同时显示Both accounts showingBoth accounts showing的两个帐户

  1. 通过转到 文件>帐户设置...打开“帐户设置”对话框。

  2. 所有帐户 子菜单中,选择“+ 添加”以添加帐户,然后选择 GitHub

    显示“添加 GitHub 帐户”选项的屏幕截图。

  3. 你将重定向到浏览器,你可以在其中使用 GitHub 凭据登录。 登录后,会在浏览器中获得成功窗口,并可以返回到 Visual Studio。

  4. GitHub 帐户现在会显示在 所有帐户 子菜单中。 此帐户将成为 活动 帐户。

    显示“帐户设置”对话框中多个 GitHub 帐户的屏幕截图。

切换 活动 帐户

可以从 个人资料卡“帐户设置” 对话框将活动帐户切换到另一个已登录的 GitHub 帐户。

使用个人资料卡片切换

选择 IDE 右上角的“登录”链接,为要新建活动帐户的帐户选择...,然后选择“设置为活动帐户”。

显示使用个人资料卡设置其他活动 GitHub 帐户的屏幕截图。

使用帐户设置切换

打开您想要设置为新的活动帐户的帐户选项,通过单击该帐户旁边的...,然后选择“设为活动帐户”。

显示使用帐户设置设置其他活动帐户的屏幕截图。

启用 GitHub 企业帐户

默认情况下,Visual Studio 仅启用公共 GitHub 帐户。 使用以下步骤添加 GitHub Enterprise Server 帐户或与 .ghe.com 终结点关联的帐户。

  1. 若要启用 GitHub 企业帐户,请转到 工具>选项 并搜索 帐户 选项。

    GitHub 帐户的屏幕截图。

  2. 然后,选中“包括 GitHub Enterprise Server 帐户”复选框。 下次转到 帐户设置 并尝试添加 GitHub 帐户时,你将看到 GitHub 和 GitHub Enterprise 的选项。

    显示使用 GitHub Enterprise 登录的 屏幕截图。

  3. 输入 GitHub Enterprise 服务器地址后,选择 使用浏览器登录。 在那里,可以使用 GitHub Enterprise 凭据登录。

  1. 若要启用 GitHub 企业帐户,请转到 “工具>选项>更多帐户”。

    GitHub 帐户的屏幕截图。

  2. 然后,选中包含 GitHub Enterprise Cloud 和 GitHub Enterprise Server 帐户的框。 下次转到 帐户设置 并尝试添加 GitHub 帐户时,你将看到 GitHub 和 GitHub Enterprise 的选项。

    显示使用 GitHub Enterprise 登录的屏幕截图。

  3. 在输入 GitHub Enterprise URL 后,选择“使用浏览器登录”。 在那里,可以使用 GitHub Enterprise 凭据登录。

备注

若要添加帐户以访问 github.com 资源(如 github.com/enterprises/*),请按照 步骤添加公共 GitHub 帐户。

添加 GitHub Enterprise Managed User (EMU) 帐户

可以添加 GitHub EMU 帐户,如下所示:

使用个人资料卡管理帐户

  1. 在 Visual Studio 环境的右上角选择带有缩写的图标。 然后选择 添加另一个帐户>GitHub

    添加企业托管用户的屏幕截图。

  2. 你将重定向到浏览器,可在其中使用 GitHub EMU 凭据登录。

使用“帐户设置”对话框管理帐户

  1. 在 Visual Studio 环境的右上角选择带有缩写的图标。 通过选择 帐户设置 或转到“文件>帐户设置...”打开“帐户设置”对话框。

    “帐户设置”窗口的屏幕截图。

  2. 所有帐户 子菜单中,选择“+ 添加”下拉列表以添加帐户,然后选择 GitHub

    显示如何选择和添加 GitHub 帐户的屏幕截图。

  3. 在“连接到 GitHub”对话框上,选择“GitHub Enterprise”

  1. 在 Visual Studio 环境的右上角选择带有缩写的图标。 通过选择 帐户设置 或转到“文件>帐户设置...”打开“帐户设置”对话框。

    “帐户设置”窗口的屏幕截图。

  2. 所有帐户 子菜单中,选择“+ 添加”下拉列表以添加帐户,然后选择 GitHub

    显示如何选择和添加 GitHub 帐户的屏幕截图。

  3. 在“连接到 GitHub”对话框上,选择“GitHub Enterprise”

备注

确保在此页上输入 GitHub EMU 帐户凭据(用户名有下划线后跟公司名称)。

显示 GitHub Enterprise 托管用户帐户的 GitHub 登录体验的屏幕截图。

登录后,会在浏览器中获得成功窗口,并可以返回到 Visual Studio。

显示浏览器中登录成功窗口的屏幕截图。

删除帐户

若要删除帐户,请在“帐户设置” 对话框中选择要从 所有帐户 子菜单中删除的帐户 删除

  1. 选择“文件”>“帐户设置...”
  2. 所有帐户 列出登录到 Visual Studio 的所有帐户。 为要删除的帐户选择 删除
  3. 在出现的对话框中确认删除。

删除帐户:

  1. 在 Visual Studio 环境的右上角选择你的个人资料图标。

  2. 要删除帐户时,请选择 删除帐户

    删除帐户的屏幕截图。

还可以使用 帐户设置 对话框删除帐户。

  1. 选择“文件”>“帐户设置...”

  2. 所有帐户 列出登录到 Visual Studio 的所有帐户。 为要删除的帐户选择 删除

  3. 在出现的对话框中确认删除。

    在帐户设置中删除帐户的屏幕截图。

排查登录问题

如果在添加或重新对 GitHub 帐户进行身份验证时遇到问题,请尝试以下步骤:

HTTP 严格传输安全性 (HSTS) 问题

验证系统的默认 Web 浏览器上是否未为 localhost 启用 HTTP 严格传输安全性(HSTS):

  • 在 Microsoft Edge 上,可以键入:edge://net-internals/#hsts 并在 localhost”部分下输入
  • 在 Google Chrome 上,键入:chrome://net-internals/#hsts 并在 localhost 部分下输入

运行方式问题

使用与已登录 Windows 帐户不匹配的帐户运行 Visual Studio 可能会导致将 GitHub 帐户添加到 Visual Studio 时出现问题。 使用尝试提升 Visual Studio 的第三方产品时,可能会遇到此问题。

可以按照以下步骤验证用户:

  1. 打开 Task Manager
  2. 导航到“Details”选项卡
  3. 搜索 devenv.exe 进程
  4. 确保该过程的用户名与已登录的 Windows 帐户匹配

若要解决此问题,请在登录到 Windows 的用户身份运行 Visual Studio,然后添加 GitHub 帐户。

备注

如果仍然遇到登录问题,请报告问题