IntelliJ IDEA 集成 GitLab 完整工作流指南

前言

本文将详细介绍如何通过 IntelliJ IDEA 实现与 GitLab 集成，完成完整的 Git 工作流程。主要内容包括：IDEA 的 Git 配置、GitLab 项目创建与导入，以及日常开发中最常用的 Git 操作，涵盖代码提交与推送、分支管理、合并冲突解决和提交历史查看/回滚等核心功能。

系统：macOS；IDE：IntelliJ IDEA；版本控制：Git；托管平台：GitLab。

一、IDEA 配置 Git

打开 IDEA -> 点击右上角设置图标 -> 偏好设置 -> 搜索 Git

在版本控制目录下 -> 点击 Git -> Git 可执行文件路径：通常为 /usr/local/bin/git

二、GitLab 创建项目并导入 IDEA

1. 登录 GitLab -> 点击 Menu -> Projects -> Your projects -> new project 创建一个新项目
2. 项目创建后，自动跳转到项目页面，点击 Clone -> Clone with SSH 右侧的复制按钮，SSH 路径结构：ssh://[email protected]:xxx/xxx/my_project.git

项目导入 IDEA 有两种方式，可自行选择：

方式一： 打开 IDEA -> 点击克隆仓库 -> URL 填入复制的 SSH URL，目录为本地电脑存放项目代码目录 -> 克隆，即可进入项目界面。

方式二：

1. 在终端进入存放项目代码目录，例如：

cd /Users/mac/Desktop/test 

2. 克隆仓库：

git clone ssh://[email protected]:xxx/xxx/my_project.git 

克隆完成后，会出现以下提示：

3. 打开 IDEA，打开克隆后的项目，即可进入项目界面。

三、IDEA 运行项目

在合作开发的场景下，克隆的项目都不为空，因此这里使用 AI 助手创建了一个简单的 JAVA 项目，没有涉及架构，仅用于学习 Git。项目架构如下：

gitlab_test/
├── README.md # 项目说明文档
├── TECHNICAL_DOCUMENTATION.md # 技术文档（本文件）
├── .gitignore # Git 忽略文件配置
├── pom.xml # Maven 项目配置文件
├── config/ # 配置文件目录
│ └── app.properties # 应用配置文件
└── src/ # 源代码目录
    ├── main/ 
    │ └── java/ 
    │ └── com/
    │ └── example/ 
    │ ├── HelloWorld.java 
    │ ├── Calculator.java 
    │ └── User.java 
    └── / 
        └── java/ 
            └── com/
                └── example/ 
                    ├── HelloWorldTest.java 
                    └── CalculatorTest.java