# 设置 GitHub 帐户 > For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt). > **TL;DR** > GitHub 设置： `设置 | 版本控制 | GitHub` > > > > 所需插件： Git 和 GitHub （默认捆绑并启用） ## 添加 GitHub 帐户 要从托管在 GitHub 上的仓库检索数据或共享项目，需要在 IntelliJ IDEA 中登录 GitHub 帐户。 > **Note:** > 如果您不想每次 [与远程同步](sync-with-a-remote-repository.html) 或 [推送](commit-and-push-changes.html) 您的提交时都指定凭据，您可以配置 IntelliJ IDEA 保存您的帐户信息（请参阅 [配置密码策略](set-up-a-git-repository.html#password-policy)）。 Procedure: 通过登录 GitHub 添加现有帐户 1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择 `版本控制 | GitHub` 。 2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 添加 并选择 通过 GitHub 登录 。 3. 在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您已启用 [双重身份验证](https://blog.github.com/2013-09-03-two-factor-authentication/)，系统会要求您输入一个将通过短信或移动应用程序发送给您的代码。 授权通过 OAuth 2.0 完成。 Procedure: 使用令牌添加现有帐户 1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择 `版本控制 | GitHub` 。 2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 添加 并选择 使用令牌登录 。 3. 请执行以下操作之一： * 如果您已经有一个令牌，请将其插入到 添加 GitHub 帐户 对话窗口中： ![添加 GitHub 帐户和令牌](https://resources.jetbrains.com/help/img/idea/2026.3/add_github_account.png) * 要获取新令牌，请点击 生成 。 在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您已启用 [双重身份验证](https://blog.github.com/2013-09-03-two-factor-authentication/)，系统会要求您输入一个将通过短信或移动应用程序发送给您的代码。 在令牌生成页面，请确保已启用以下作用域： repo 、 代码片段 (gist) 、 read:org 、 workflow 、 read:user 、 user:email （请参阅 [Understanding scopes](https://developer.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/)）。 > **Note:** > [细粒度个人访问令牌](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#fine-grained-personal-access-tokens)目前尚未完全提供开箱即用支持，但 IDE 不限制其使用。 > > > > 若要使用精细化令牌，请授予与经典令牌作用域等效的权限。 如果令牌在使用期间缺少任何必要权限，IDE 将显示错误。 点击 生成令牌 ，复制令牌，并将其粘贴到 添加 GitHub 帐户 对话窗口中。 4. 点击 添加账户 。 请参阅 [创建个人访问令牌](https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line)以获取有关 GitHub 令牌的更多详细信息。 Procedure: 登录 GitHub Enterprise 帐户 1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择 `版本控制 | GitHub` 。 2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 添加 并选择 登录 GitHub Enterprise 。 3. 在 服务器 字段中，输入 GitHub Enterprise 服务器的 URL。 例如， `github.com` 用于 GitHub Enterprise Cloud， `example.ghe.com` 用于 GitHub Enterprise Cloud（带数据驻留），也可以使用贵公司使用的自托管服务器的 URL。 4. 请执行以下操作之一： * 如果您已经有一个令牌，请将其插入到 添加 GitHub 帐户 对话窗口中： ![使用令牌添加 GitHub Enterprise 帐户](https://resources.jetbrains.com/help/img/idea/2026.3/gh_enterprise_server.png) * 要获取新令牌，请点击 生成 。 在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您已启用 [双重身份验证](https://blog.github.com/2013-09-03-two-factor-authentication/)，系统会要求您输入一个将通过短信或移动应用程序发送给您的代码。 在令牌生成页面，请确保已启用以下作用域： repo 、 代码片段 (gist) 、 read:org 、 workflow 、 read:user 、 user:email （请参阅 [Understanding scopes](https://developer.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/)）。 > **Note:** > [细粒度个人访问令牌](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#fine-grained-personal-access-tokens)目前尚未完全提供开箱即用支持，但 IDE 不限制其使用。 > > > > 若要使用精细化令牌，请授予与经典令牌作用域等效的权限。 如果令牌在使用期间缺少任何必要权限，IDE 将显示错误。 点击 生成令牌 ，复制令牌，并将其粘贴到 添加 GitHub 帐户 对话窗口中。 5. 点击 添加账户 。 Procedure: 更新已过期的令牌 1. 令牌过期后，尝试将更改推送到 GitHub 仓库时，会看到以下警告： ![令牌过期警告](https://resources.jetbrains.com/help/img/idea/2026.3/ws_expired_token.png) 点击 使用 Token 。 2. 请执行以下操作之一： * 如果您已经有一个令牌，请将其插入到 登录到 GitHub 对话窗口中： ![添加 GitHub 帐户和令牌](https://resources.jetbrains.com/help/img/idea/2026.3/update_gh_token.png) * 要获取新令牌，请点击 生成 。 在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您已启用 [双重身份验证](https://blog.github.com/2013-09-03-two-factor-authentication/)，系统会要求您输入一个将通过短信或移动应用程序发送给您的代码。 在令牌生成页面，请确保已启用以下作用域： repo 、 代码片段 (gist) 、 read:org 、 workflow 、 read:user 、 user:email （请参阅 [Understanding scopes](https://developer.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/)）。 > **Note:** > [细粒度个人访问令牌](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#fine-grained-personal-access-tokens)目前尚未完全提供开箱即用支持，但 IDE 不限制其使用。 > > > > 若要使用精细化令牌，请授予与经典令牌作用域等效的权限。 如果令牌在使用期间缺少任何必要权限，IDE 将显示错误。 点击 生成令牌 ，复制令牌，并将其粘贴到 登录到 GitHub 对话窗口中。 3. 点击 登录 Procedure: 创建一个新的 GitHub 帐户 1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择 `版本控制 | GitHub` 。 2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 添加 并选择 通过 GitHub 登录 。 3. 在打开的浏览器窗口中，点击 创建帐户 并完成 GitHub 上的注册流程。 4. 返回 IntelliJ IDEA 设置，点击 取消 ，然后重复步骤 2 和 3。 5. 在浏览器中点击 授权 JetBrains 。 Procedure: 管理多个 GitHub 帐户 您可以在 IntelliJ IDEA 中使用多个 GitHub 帐户：例如，使用个人帐户参与开源项目，并使用公司帐户进行主要工作。 1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择 `版本控制 | GitHub` 。 2. 使用 ![添加图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 添加 添加所需数量的帐户。 3. （可选）要将某个帐户设置为当前项目的默认帐户，请选择该帐户并点击 ![“检查”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.checked.svg) 设为默认 。 如果设置了默认帐户，当 [在 GitHub 上共享项目](manage-projects-hosted-on-github.html#share-on-GitHub)、 [对复刻进行变基](fork-github-projects.html#rebase-fork)、 [创建拉取请求](create-and-merge-github-pull-requests.html#create-pull-request)或 [创建 gist](share-code-with-gists.html)时，IntelliJ IDEA 不会要求选择要使用的帐户。 > **Tip:** > 如果无法在 IDE 中查看拉取请求，或者在登录 GitHub 帐户并执行任何 Git 操作时出现错误，请参阅 [GitHub 仓库操作失败](https://intellij-support.jetbrains.com/hc/en-us/articles/4404416401042-Operations-Against-a-GitHub-Repository-Are-Failing)一文以获取故障排除提示。 ## See also ### 过程 [Using Git in IntelliJ IDEA](using-git-integration.html) [设置 Git 仓库](set-up-a-git-repository.html) ### 外部链接 [Scopes for OAuth Apps on GitHub](https://developer.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/) [Two-factor Authentication on GitHub](https://blog.github.com/2013-09-03-two-factor-authentication/)