# 配置 GitLab 帐户

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

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

使用 IntelliJ IDEA ，您可以：

* 在不离开 IDE 的情况下 [访问您的 GitLab 项目](#manage-gitlab-accounts)。

* [克隆并共享项目](clone-gitlab-project.html)，这些项目托管在 GitLab 上。

* [处理 GitLab 合并请求](work-with-gitlab-merge-requests.html)。

* [在 GitLab 配置文件中定义 CI/CD 作业](gitlab-ci-cd.html)。

> **Note:**
> 集成支持 GitLab Community Edition 和 GitLab Enterprise Edition 14.0 及更高版本。

## 管理 GitLab 帐户

要从托管在 GitLab 上的项目中检索数据或分享您的项目，您需要登录到您在 IntelliJ IDEA 上的 GitLab 帐户。

Procedure: 登录 GitLab

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)) 打开设置，然后选择  `版本控制 | GitLab` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)。   添加 GitLab 帐户  对话框打开：

![添加 GitHub 帐户对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_log_in_with_access_token.png)

3. 在对话框中，执行下列操作之一：

* 如果您已经有令牌，请将其插入 令牌 字段。

* 如果您没有 token，请点击 生成 。 在打开的令牌生成页面中，请确保已选择 `api` 和 `read_user` 作用域。 点击 创建个人访问令牌 ，复制令牌，并将其粘贴到 添加 GitLab 帐户 对话窗口中。

4. 点击   登录  。

当您的令牌过期时，尝试将更改推送到 GitLab 仓库时，您会收到警告。 您可以使用此警告生成新的令牌，或者在  `设置 | 版本控制 | GitLab`  中删除并重新添加您的账户。

请参阅 [个人访问令牌](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)以获取有关 GitLab 令牌的更多详细信息。

Procedure: 管理多个 GitLab 帐户

您可以在 IntelliJ IDEA 中使用多个 GitLab 帐户：例如，使用个人帐户来参与开源项目，并使用公司帐户处理您的主要工作。

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)) 打开设置，然后选择  `版本控制 | GitLab` 。

2. 请使用 ![添加图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 按钮添加所需的任意数量的帐户。

3. 要将帐户设置为当前项目的默认帐户，请选择它并点击 ![“检查”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.checked.svg)。

![检查按钮以设置默认帐户](https://resources.jetbrains.com.cn/help/img/idea/2026.3/set_default_account_gitlab.png)