# 管理托管在 GitLab 上的项目

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

> **TL;DR**
> GitLab 设置：  `设置 | 版本控制 | GitLab`
>
>
>
> 所需插件：   Git   和   GitLab  （默认捆绑并启用）

## 克隆 GitLab 项目

您可以直接从 IntelliJ IDEA 克隆 您希望参与贡献的 [一个 GitLab 项目](https://docs.gitlab.com/user/project/repository/)，并基于其创建一个新项目。

在克隆项目之前，请确保您 [已登录](set-up-a-gitlab-account.html#log-in-to-gitlab)到GitLab帐户。

Procedure:

1. 使用以下选项之一打开   克隆存储库  对话框：

* 在主菜单中，前往 `Git | 克隆` 。

* 如果 Git 菜单不可用，请转到 `文件 | 新建 | 从版本控制创建项目` 。

* 在欢迎屏幕上，点击 克隆存储库 按钮。

2. 在   克隆存储库   对话框中，指定要克隆的项目的 URL。

![克隆仓库对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/gl_clone_repository.png)

或者，打开   GitLab   标签页，该标签页位于   克隆存储库   对话框左侧。 从与你的账户及其所属组织关联的所有 GitLab 项目列表中选择一个仓库。

3. 在   目录   字段中，输入将创建本地 Git 项目的文件夹路径。

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

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

5. 点击   克隆  。

## 在 GitLab 上共享项目

您可以为本地项目添加远程 GitLab 存储库，以便其他人查看或参与贡献。

在共享项目之前，请确保您已 [登录到您的 GitLab 帐户](set-up-a-gitlab-account.html#manage-gitlab-accounts)。

Procedure:

1. 打开您的本地项目。

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

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

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

3. 在打开的对话框中，选择 GitLab 账户和 [命名空间](https://docs.gitlab.com/user/namespace/)。 您还可以更改存储库名称（默认情况下与项目名称相同）、远程的名称（默认为 origin）、选择存储库类型（公开或私有），并在需要时添加说明：

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

4. 点击   分享  。

项目发布后，您始终可以在主菜单中选择  `Git | GitLab | 在 GitLab 上打开` ，在浏览器中打开它。