# 管理托管在 GitHub 上的项目

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

## 查看项目（克隆）

您可以从 IntelliJ IDEA 直接克隆一个您想要贡献的 [repository](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-repositories) 并基于它创建一个新的 project。

Procedure:

1. 在主菜单中，前往  `Git | 克隆` 。 如果   Git  菜单不可用，请选择  `VCS | 从版本控制获取` 。

2. 在   从版本控制获取   对话框中，选择左侧的   GitHub  。

3. 通过以下任一方式登录 GitHub：

* 如果您有令牌，请点击 使用 token ，然后在 令牌 字段中粘贴令牌，并点击 登录 。

* 否则，请点击 通过 GitHub 登录 。 在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您已启用 [双重身份验证](https://blog.github.com/2013-09-03-two-factor-authentication/)，系统会要求您输入一个将通过短信或移动应用程序发送给您的代码。

> **Tip:**
> 有关管理 GitHub 帐户的更多信息，请参阅 [添加 GitHub 帐户](set-up-a-github-account.html#register-account)。

4. 从与您的帐户及帐户所属组织关联的所有 GitHub 项目列表中选择一个代码库。

5. 在   目录   字段中，输入创建本地 Git 存储库的文件夹路径。

6. 如果要执行历史记录有限的 [浅克隆](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt-code--depthcodeemltdepthgtem)，请选择   浅克隆，历史截断为   复选框，并指定要克隆的提交数。

您可以稍后通过在主菜单中选择   Git | 取消浅克隆存储库  来获取其余的历史记录。

7. 点击   克隆  。

如果您希望基于这些源创建项目，请在确认对话框中点击   是  。 IntelliJ IDEA 会自动将 Git 根映射设置为项目根目录。

## 在 GitHub 上共享项目

您可以为正在本地开发的 project 添加一个远程 GitHub 仓库，以便其他人查看或贡献。

Procedure:

1. 打开您要共享的 project。

2. 如果您的项目已由 Git 跟踪，请在主菜单中转到  `Git | GitHub | 在 GitHub 上共享项目` 。

如果您尚未启用版本控制集成，请在主菜单中转到  `VCS | 在 GitHub 上共享项目` 。

> **Tip:**
> 了解有关 [将现有项目置于 Git 版本控制之下](set-up-a-git-repository.html#put-existing-project-under-Git)的更多信息。

3. 如果您已在 IntelliJ IDEA 中 [注册了您的 GitHub 帐户](set-up-a-github-account.html#register-account)，将使用这些凭据建立连接。

如果您尚未在 IntelliJ IDEA 中注册帐户，将会打开   登录到 GitHub   对话框。 请指定您的访问令牌，或使用您的登录名和密码请求一个新的令牌。

4. 与 GitHub 的连接建立后，将打开   在 GitHub 上共享项目   对话框。 指定新仓库的名称、远程的名称，并输入您项目的描述。

如果不希望允许其他 GitHub 用户公共访问您的存储库，您可以选择   私有   选项。

![在 GitHub 对话框上共享项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/py_share_project_on_github.png)

您在   远程  字段中指定的名称将在  `Git | 管理远程` 对话框中进一步可见。 有关更多信息，请参阅 [Add a remote repository](set-up-a-git-repository.html#add-remote)。

5. 点击   分享   以启动新的存储库并将 project 源上传到其中。

## 跳转到文件的 GitHub 版本

您可以从 IntelliJ IDEA 跳转到该文件的 GitHub 版本。 IntelliJ IDEA 可以检测当前活跃的分支以及文件的最新修订版，并在您的网页浏览器中打开对应提交中的选定文件的 GitHub 副本。

Procedure:

1. 请执行以下操作之一：

* 从主菜单中选择 `Git | GitHub | 在 GitHub 上打开` 。

* 在编辑器或 项目视图 中选择一个文件，然后从上下文菜单中选择 `在 GitHub 中打开` 。 ![打开 GitHub 版本的文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_open_on_github_menupath.png)

* 在 项目视图 中选择文件，按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))，然后输入 `Open on Github` 。 ![从弹出窗口中打开文件的 GitHub 版本](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_open_on_github_popup.png)

2. 如果您已登录 GitHub，文件的远程版本将在浏览器中打开。

否则：

* 在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您已启用 [双重身份验证](https://blog.github.com/2013-09-03-two-factor-authentication/)，系统会要求您输入一个将通过短信或移动应用程序发送给您的代码。

如果您从编辑器中打开 GitHub 文件版本，该文件也将自动滚动到当前行。

如果该文件指向多个远程，您将被提示选择适当的代码库。

