首页/开发/Git 与协作速查/MR 模板文件(GitLab)
协作与代码评审75 条

MR 模板文件(GitLab)

GitLab 使用 .gitlab/merge_request_templates/ 目录存放模板,新建 MR 时从下拉选择;实例级模板可统一组织规范。

Git 与协作速查开发更新于 2026-10-12
仓库级.gitlab/merge_request_templates/<名称>.md
实例级管理员在 Admin Area 配置默认模板
选择方式新建 MR 页面 Description 上方的模板下拉

目录结构示例

目录结构示例
.gitlab/
  merge_request_templates/
    Default.md
    Bugfix.md
    Release.md
多个模板适合不同类型的变更(缺陷修复、发布、实验特性),每个模板保持 10 行以内更实用。

易错点

  • 模板目录名拼写错误(单复数、大小写)会导致下拉里不出现,配置后用测试 MR 验证
  • 实例级与仓库级模板同时存在时以仓库级优先,排查时两层都要看

数据来源与参考

  • GitLab Docs:Description templates(merge request templates)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌