如何使用gitlab：基础协作流程

如何使用gitlab的完整操作链路分为账号注册、项目创建、本地代码拉取、分支开发、提交推送、合并请求、CI流水线配置，适合开发团队、独立开发者做代码托管与协同；不适合完全不懂Git基础命令，且没有终端操作能力的使用者，这类人群需要先掌握gitadd、gitcommit等基础指令再上手。你优先选择SaaS在线实例可以跳过服务器运维，私有化部署则需要自行维护服务器、数据库与存储资源，GitLab官方文档为这套操作提供完整的参考依据。

如何使用gitlab：账号与项目初始化

你打开GitLab官网或者私有化部署的访问地址，注册账号并完成邮箱验证，进入个人主页后点击新建项目，选择空白项目，填写项目名称、项目描述，勾选初始化README文件，分支名称默认设置为main，点击创建。项目创建完成后，页面会展示仓库地址，支持HTTPS和SSH两种协议，SSH方式需要提前在本机生成密钥，将公钥粘贴到GitLab账号的SSH密钥配置页，后续提交代码不用重复输入账号密码，HTTPS每次推送会校验账号凭证。

配置SSH密钥。

如何使用gitlab：本地仓库操作

打开本地终端，切换到存放代码的文件夹，执行gitclone加上仓库地址，把远程仓库下载到本地电脑，进入项目目录。不要直接在main主分支修改代码，执行gitcheckout-b自定义分支名创建并切换到新分支，所有业务代码修改都放在这个特性分支内。文件修改完成后，执行gitadd.把改动加入暂存区，再执行gitcommit-m加上简短清晰的提交备注，备注要写清楚本次改动的内容，便于后续追溯代码历史，最后执行gitpush，把本地分支推送到GitLab远程仓库。

如何使用gitlab：合并请求与代码评审

代码推送成功后，GitLab页面会弹出创建合并请求的入口，点击进入，选择源分支为你刚推送的特性分支，目标分支设置为main，填写变更说明，指定评审人后提交合并请求。评审人可以在线查看代码差异，在代码行添加评论，提出修改意见，你收到评论后回到本地分支修改代码，再次提交并推送，合并请求会自动更新。评审全部通过后，点击合并按钮，代码就会并入main分支，合并完成后可以删除已经合并完毕的特性分支，减少仓库内冗余分支。

如何使用gitlab：CI/CD流水线配置

在项目根目录新建.gitlab-ci.yml文件，这个文件用来定义流水线任务，包含构建、测试、部署等阶段，每个阶段可以编写对应的执行脚本。文件提交推送到仓库后，GitLab会自动识别配置文件，调用Runner执行流水线任务。Runner是独立执行任务的代理程序，SaaS版本自带共享Runner，私有化部署需要手动安装并注册Runner，分配给当前项目使用。流水线运行日志会实时展示在页面，任务失败时可以查看日志定位问题，调整脚本后重新提交触发再次运行。

该方法的适用边界是，私有化部署服务器最低配置需要4核8G内存，低于这个配置会出现页面加载缓慢、流水线任务执行超时，不建议在低配云服务器上部署生产环境GitLab实例。

权限管理在项目设置页面完成，你可以给团队成员分配不同角色，访客只能查看公开项目，报告者可以提issue，开发者拥有代码推送权限，维护者可以管理合并请求，所有者拥有项目全部管理权限。项目还可以创建分组，把多个项目归入同一分组，批量统一管理成员权限，适合多项目并行开发的团队。

一个常见错误操作，直接在main分支本地修改并推送，会造成主分支代码混乱，多人协作时容易出现代码覆盖冲突，破坏线上稳定版本。

issue功能用于管理任务、缺陷与需求，你可以创建issue，设置标签、优先级，关联合并请求，代码合并完成后对应的issue能够自动关闭，把需求、缺陷和代码变更串联起来，实现开发流程的统一管理。