Linux下使用 GitLab 进行代码审查的实操指南

一 环境与权限准备

• 安装与访问：在 Linux（如 CentOS） 上部署 GitLab，安装依赖（如 curl、policycoreutils、openssh-server），启动 sshd，放行 80/443 端口；添加 GitLab 仓库后安装 gitlab-ce/ee，在 /etc/gitlab/gitlab.rb 中设置 external_url 并执行 gitlab-ctl reconfigure 生效。完成后即可通过浏览器访问 GitLab Web 界面。
• 成员与角色：在项目的 Group/Members 中分配角色（如 Guest、Reporter、Developer、Maintainer/Owner），确保审查与合并权限受控。
• 分支防护：进入 Settings → Repository → Protected Branches，对 main/develop 等分支设置“Allowed to push/Allowed to merge”，常见做法是仅允许 Maintainers/Owners 合并，必要时禁止直接推送，强制走 Merge Request + 审批 流程。

二 开发者侧操作流程

• 本地分支开发：基于目标分支（如 develop）创建功能分支，提交并推送到远端。示例：
  • git checkout develop && git pull
  • git checkout -b feature-xyz

  • 编码与本地自测

  • git add . && git commit -m “feat: xxx”
  • git push origin feature-xyz
• 发起合并请求 MR：在 GitLab 项目页面点击 Merge Requests → New merge request，选择源分支（如 feature-xyz）与目标分支（如 develop），填写 标题/描述，指派 审查者（Reviewer），可设置 标签 与 里程碑，提交 MR。
• 处理反馈与冲突：审查者提出评论后，开发者在本地修改并 git push 更新 MR；若合并出现冲突，建议在本地将目标分支合并到功能分支解决冲突后再次推送：
  • git checkout feature-xyz
  • git pull origin develop

  • 解决冲突 → add/commit/push

• 合并与清理：审查通过并满足流水线要求后由具有权限的成员点击 Merge 完成合并，必要时删除已合并的 feature 分支。

三 审查者侧操作要点

• 查看与评论：在 MR 页面使用 Inline 或 Side-by-side 模式逐行查看差异，添加 评论/建议；对需要修改的点使用 Start a review 进行多行/多处的集中评审，最后 Submit review。
• 批准与状态：当代码满足质量与规范时点击 Approve；如项目启用了 审批规则，需满足所需审批数方可合并。
• 冲突与协作：若 MR 存在冲突，可提示开发者按上一节方式在本地解决；必要时在 MR 讨论区沟通方案与变更范围。

四 自动化与质量门禁

• 配置 CI/CD：在项目根目录添加 .gitlab-ci.yml，定义 build、test、lint 等作业；MR 会自动触发流水线，审查者可结合 流水线状态 作为是否可合并的参考。示例：
  • stages: [build, test, lint]
  • build: script: ./gradlew build || make build
  • test: script: ./gradlew test || pytest
  • lint: script: eslint . || pylint **/*.py
• 代码质量工具：在 CI 中集成 ESLint、RuboCop、Pylint、Checkstyle 等静态检查，结合 项目配置（如 .eslintrc.js、.rubocop.yml）统一规范；必要时使用 Git 钩子 做提交前本地校验，降低问题流入 MR 的概率。

五 最佳实践与提效建议

• 分支策略：采用 Git Flow 或 Trunk Based Development，功能开发走 短生命周期分支，通过 MR 合并回 main/develop。
• 模板与规范：使用 Issue/Merge Request 模板 统一上下文信息（背景、变更范围、影响评估、测试要点），提升评审效率与可追溯性。
• 权限与审批：对 main/develop/release-* 等分支启用 分支保护 与 最少审批数，必要时要求 流水线通过 与 代码所有者审批。
• 角色分工：明确 Developer/Reviewer/Maintainer 的职责边界，鼓励建设性反馈与结对评审。
• 工具集成：在 IDE（如 IntelliJ IDEA） 安装 GitLab 插件，在编辑器内创建、查看与处理 MR；结合 GitLab Duo Chat 快速定位问题、生成说明，提高评审速度与质量。