Ubuntu 上使用 GitLab 进行代码审查的标准流程
在 Ubuntu 环境中，GitLab 的代码审查以 合并请求 Merge Request（MR） 为核心，配合 受保护分支、CI/CD 自动化检查 与 评审规则 实现高效协作与质量把关。以下给出可直接落地的操作指引与最佳实践。
一 环境与权限准备
- 安装与初始化
- 在 Ubuntu 20.04/22.04 上安装 GitLab（Omnibus 包），完成后执行
sudo gitlab-ctl reconfigure 初始化服务。
- 角色与权限
- 项目成员常见角色含 Guest / Reporter / Developer / Maintainer / Owner；建议仅授予 Maintainer/Owner 合并权限，开发者通过 MR 提交变更。
- 分支防护
- 进入 Settings → Repository → Protected Branches，锁定 main/master、release-* 等分支；仅允许通过 MR 合并，禁止直接推送；可设置“合并前需批准”“必需状态检查通过”等策略。
二 开发者创建合并请求
- 本地分支开发
- 创建功能分支：
git checkout -b feature/your-feature
- 提交与推送：
git add . && git commit -m "feat: add xxx" && git push origin feature/your-feature
- 在 GitLab 创建 MR
- 进入项目 → Merge Requests → New merge request，选择源分支与目标分支（如 feature/xxx → main）。
- 填写 标题/描述，使用 #任务编号 关联需求；指派 Assignee/Reviewer，可设置 必需审批数 与 里程碑。
- 持续更新 MR
- 根据评审意见在本地修改后再次
git push，MR 会自动更新差异与评论线程。
三 评审与合并操作
- 在线评审
- 评审者在 MR 页面查看 Diff，对代码行添加 评论/建议；可使用 Web IDE 进行轻量修改；支持线程化讨论与 解决/未解决 状态管理。
- 冲突处理
- 若 MR 存在 合并冲突，开发者需在本地 rebase/merge 解决后再次推送；或在 MR 页面使用 解决冲突 工具处理（视项目设置而定）。
- 自动化质量门禁
- 通过 .gitlab-ci.yml 配置构建、单元测试、代码风格/质量检查（如 ESLint、RuboCop、Pylint 等）；在 Settings → CI/CD → General pipelines 启用 Merge when pipeline succeeds，确保测试通过方可合并。
- 批准与合并
- 达到 必需审批数 且 CI 通过 后，由具有权限的成员执行 Merge；可选择 Squash and merge 或 Merge commit 策略保持提交历史整洁。
四 审查效率与质量提升
- 模板与规范
- 使用 Issue/Merge Request 模板 统一变更说明与验收标准；在 MR 描述中清晰标注 变更范围、影响点、测试覆盖。
- 工具集成
- IDE 插件（如 IntelliJ IDEA GitLab 插件）支持在 IDE 内创建/管理 MR、查看评论与流水线状态；提交前通过 Git 钩子/客户端工具 做基础校验。
- AI 辅助
- 引入 GitLab Duo Chat 快速解答评审问题、定位变更意图；或部署开源 AI-Codereview-Gitlab，通过 Webhook + Access Token 调用大模型，在 MR/Commit 下自动留下审查意见并推送到 钉钉/企业微信/飞书。
- 代码质量平台
- 结合 GitLab Code Quality 与 SonarQube 做静态分析、复杂度与漏洞扫描；将质量报告作为 MR 的 状态检查，未达标则禁止合并。
五 常见问题与排查
- CI 失败阻塞合并
- 在 Pipelines 查看失败任务日志，修复后再次推送；必要时在 MR 页面重跑流水线。
- 合并冲突
- 本地执行
git rebase main 或 git merge main 解决冲突，提交并推送；如冲突复杂，可使用网页端冲突解决工具。
- 权限或分支保护导致无法合并
- 检查 Protected Branches 与 角色权限 配置；确认已获得 Maintainer/Owner 合并权限且 审批/状态检查 条件满足。
- 服务可用性
- 使用
curl -I http://localhost 或 sudo gitlab-ctl status 检查 GitLab 服务状态；异常时查看 /var/log/gitlab/ 日志。
