GitLab 零基础入门教程:从安装配置到代码协作全流程

关注上方蓝字"风景邮递Yuan"，选择"设为置顶or星标"

第一时间获取前沿AI技术&AI资讯

文章底部可留言🌸

一、前言

在现代软件开发流程中，代码版本管理与团队协作是项目迭代的核心基础。GitLab 作为一款开源的一站式 DevOps 平台，整合了 Git 版本控制、代码仓库管理、团队协作、CI/CD 持续集成、项目运维监控等全套能力，是企业开发、个人开源、团队协作的主流工具之一。

不同于单纯的 Git 命令行，GitLab 提供可视化网页管理界面，降低了版本控制的学习门槛；同时相较于 GitHub，GitLab 支持本地私有化部署、免费私有仓库、自定义流水线，更适合企业内部项目、校园团队及个人开发者使用。

本文面向零基础读者，从零讲解 GitLab 核心概念、环境配置、项目创建、代码提交、分支协作及简易 CI/CD 落地，看完即可独立完成日常开发的代码托管与协作工作。

二、Git 与 GitLab 核心区别（新手必懂）

很多新手容易混淆 Git 和 GitLab，二者是互补而非替代关系：

1. Git：是本地版本控制系统，一款安装在电脑上的工具，核心作用是追踪本地代码修改、记录版本、管理分支，所有代码版本操作的底层都是 Git 命令。
2. GitLab：是云端/本地代码托管平台，基于 Git 开发的网页服务，核心作用是存储远程代码仓库、可视化管理项目、实现多人协作、自动化构建部署。

简单总结：Git 负责本地代码版本管理，GitLab 负责远程代码托管与 DevOps 全流程管理。

三、前期环境准备

使用 GitLab 无需复杂配置，仅需两步基础环境搭建，适配 Windows、Mac、Linux 全平台。

3.1 安装 Git 工具

所有 GitLab 操作都依赖本地 Git 环境，未安装需先部署：

- 下载地址：Git 官网
- 安装注意：全程默认下一步即可，无需修改配置，安装完成后右键桌面可看到「Git Bash」终端

安装验证：打开 Git Bash，输入以下命令，输出版本号即代表安装成功

3.2 注册 GitLab 账号

日常学习可直接使用官方云端服务，无需本地部署：

1. 访问官网：https://gitlab.com
2. 使用邮箱注册账号，完成邮箱验证即可免费使用
3. 国内用户也可选择极狐GitLab（gitlab.cn），访问速度更快，功能完全一致

3.3 配置 SSH 密钥（免密提交必备）

每次提交代码输入账号密码非常繁琐，配置 SSH 密钥可实现永久免密推拉代码，是 GitLab 必备配置：

1. 打开 Git Bash，生成 SSH 密钥（替换为自己的注册邮箱） 
2. 全程回车默认配置，无需设置密码
3. 查看并复制公钥内容 
4. 绑定到 GitLab 账号
- 登录 GitLab → 右上角头像 → Settings → SSH Keys
- 将复制的公钥完整粘贴，点击 Add key 即可

四、手把手创建第一个 GitLab 项目

账号和环境配置完成后，我们创建第一个远程代码仓库，用于托管项目代码。

1. 登录 GitLab 首页，点击右上角 New project（新建项目）
2. 选择 Create blank project（空白项目）
3. 填写项目核心信息：
- Project name：项目名称（必填，自定义）
- Project slug：项目地址别名（自动生成，无需修改）
- Description：项目描述（选填，记录项目功能）
- Visibility Level：权限等级
- Private：私有项目，仅自己和协作者可见（推荐个人/企业项目）
- Public：公开项目，所有人可查看克隆（开源项目使用）
4. 勾选 Initialize repository with a README（自动生成说明文件）
5. 点击 Create project，项目创建完成

五、本地代码关联远程仓库（核心实操）

项目创建后，需要将本地项目文件夹与GitLab远程仓库关联，实现代码同步，提供两种常用方式。

方式一：克隆远程仓库（推荐新手）

适合本地无代码，从零开发的场景，直接将远程空仓库克隆到本地：

1. 进入刚创建的 GitLab 项目主页，点击右上角 Code
2. 复制 SSH 地址（免密优先，HTTPS 需输密码）
3. 打开 Git Bash，进入本地存放项目的文件夹，执行克隆命令

方式二：本地已有代码，关联远程仓库

适合本地已有现成项目代码，需要上传托管的场景：

1. 进入本地项目根目录，打开 Git Bash
2. 初始化本地 Git 仓库
3. 关联 GitLab 远程仓库
4. 验证关联是否成功

 六、首次代码提交与同步（完整流程）

掌握最基础的「修改-提交-同步」流程，是日常开发高频操作，完整命令如下：

6.1 查看代码修改状态

修改本地项目文件后，查看哪些文件发生变化

6.2 暂存修改的文件

将修改后的文件加入暂存区，准备提交

6.3 本地提交版本

将暂存区文件提交到本地仓库，备注修改说明

6.4 同步到远程 GitLab 仓库

将本地版本推送至远程仓库，完成代码托管

补充：GitLab 默认主分支为  main （旧版本为  master ），命令统一使用 main 即可。

七、GitLab 核心协作功能（团队开发必备）

个人开发仅需基础推拉代码，团队协作需要掌握分支管理、合并请求两大核心功能，也是企业开发的规范流程。

7.1 分支管理规范

Git 分支可以实现多人并行开发、互不干扰，核心分支规范：

1.  main / master ：主分支，存放稳定上线代码，禁止直接修改
2.  dev ：开发分支，存放迭代中的测试代码
3. 功能分支： feat/xxx 、 fix/xxx ，开发者个人开发分支

常用分支命令

7.2 合并请求（Merge Request）

团队开发标准流程：个人分支开发 → 提交远程 → 发起合并请求 → 代码审核 → 合并到主分支

1. 个人分支开发完成后，推送分支到远程

2. 登录 GitLab 项目页，自动弹出 Create merge request
3. 填写合并说明，选择目标分支（dev/main）
4. 提交请求后，管理员/负责人审核代码
5. 审核通过后，点击 Merge 完成合并，最后删除无用分支

八、GitLab 简易 CI/CD 自动化部署（入门体验）

GitLab 最大的优势是自带 CI/CD 流水线，无需额外搭建工具，可实现代码提交后自动构建、测试、部署。

8.1 核心原理

项目根目录下的  .gitlab-ci.yml  文件是流水线配置文件，GitLab 会自动识别该文件，按照配置执行自动化任务。

8.2 入门配置实操

1. 在项目根目录创建文件，命名为  .gitlab-ci.yml 
2. 写入基础测试配置（实现提交代码自动打印日志）

3. 提交并推送配置文件到远程仓库

4. 查看流水线效果：项目页 → Build → Pipelines，可看到自动运行的任务，执行成功即代表 CI/CD 配置生效

后续可扩展配置：代码检测、打包构建、服务器自动部署、镜像推送等企业级自动化场景。

九、新手常见问题解决方案

1. SSH 推送提示权限拒绝
- 重新复制完整公钥，确认无空格换行
- 删除旧的 SSH 密钥，重新生成绑定
2. git push 报错：冲突冲突
- 远程代码和本地代码不一致，先拉取最新代码再推送 
3. 忘记分支切换，在 main 分支写代码
- 立即新建分支保存修改，避免污染主分支

十、总结

本文完成了 GitLab 从环境配置、项目创建、代码托管、团队协作到 CI/CD 自动化的零基础入门全流程，核心知识点总结：

1. Git 管本地版本，GitLab 管远程托管与 DevOps 协作
2. SSH 密钥配置是免密操作的基础，新手必配置
3. 日常核心流程：修改代码 → git add → git commit → git push
4. 团队开发遵循「分支开发+合并请求」规范，保证代码稳定性
5. GitLab CI/CD 无需第三方工具，极简配置即可实现自动化迭代

掌握以上内容，足以应对个人开发、校园项目、中小企业基础协作场景。后续进阶可深入学习 GitLab 权限管理、容器镜像托管、流水线优化、监控告警等高级功能。