📚 GitLab 全部权限角色详解
GitLab 的权限体系分为项目/群组角色 和管理员角色 ，其中项目/群组角色从低到高依次为：Guest → Reporter → Developer → Maintainer → Owner，部分版本还新增了 Planner 角色，下面为你逐一拆解说明。
🔢 权限等级对照表
| 角色 | 权限数值 | 核心定位 |
|---|---|---|
| Guest（访客） | 10 | 仅查看有限信息，无代码操作权限 |
| Reporter（报告者） | 20 | 可查看代码与进度，适合PM/QA/外部协作方 |
| Developer（开发者） | 30 | 可参与开发流程，是核心开发人员的默认角色 |
| Maintainer（维护者） | 40 | 可管理项目配置与成员，适合模块负责人/技术主管 |
| Owner（所有者） | 50 | 项目/群组最高权限，拥有完全控制权 |
| Planner（规划者） | - | 新增角色，专注于Issue/Epic/看板管理，无代码权限 |
| Administrator（管理员） | - | 实例级最高权限，可管理所有项目与系统配置 |
📌 各角色详细权限说明
1. Guest（访客，权限10）
- 适用场景：临时协作方、外部审计人员，仅需查看项目基础信息。
- 核心权限 ：
- 查看项目公开的Issue、Epic和评论
- 可对Issue/评论进行回复
- 无任何代码仓库读写权限，无法克隆、推送代码
- 无法查看私有项目的仓库内容
2. Reporter（报告者，权限20）
- 适用场景：产品经理、测试工程师、非开发岗位的项目成员。
- 核心权限 ：
- 包含Guest的所有权限
- 可查看、克隆代码仓库（只读，无法提交）
- 可创建/编辑Issue、标签、里程碑，管理看板任务
- 可查看CI/CD流水线结果，无法修改配置或手动触发
- 可下载项目制品（如构建产物、包文件）
3. Developer（开发者，权限30）
- 适用场景：项目核心开发人员，日常编码协作的主力角色。
- 核心权限 ：
- 包含Reporter的所有权限
- 可向非受保护分支推送代码、创建合并请求（MR）
- 可创建新分支、打标签（非受保护标签）
- 可手动触发CI/CD流水线、管理自己创建的流水线
- 可编辑Wiki页面、添加项目笔记
- ❌ 无法修改项目设置、管理成员，也无法直接推送到受保护分支（如main/master）
4. Maintainer（维护者，权限40）
- 适用场景：模块负责人、技术主管，负责项目流程管控与配置维护。
- 核心权限 ：
- 包含Developer的所有权限
- 可管理受保护分支/标签：修改保护规则、删除分支、直接推送代码
- 可添加/删除项目成员、修改成员角色（可设置为Developer/Reporter/Guest）
- 可编辑项目核心设置：配置Webhook、管理CI/CD变量、Runners、环境变量
- 可管理项目的部署环境、Pages服务、推送规则
- ❌ 无法删除项目、修改项目的根设置（如项目可见性、高级配置）
5. Owner（所有者，权限50）
- 适用场景：项目创建者、项目负责人，拥有项目的完全控制权。
- 核心权限 ：
- 包含Maintainer的所有权限
- 可删除项目、修改项目的可见性（公开/私有/内部）
- 可转移项目所有权、配置项目的高级安全设置
- 可删除项目的Wiki、Issue、合并请求等所有内容
- 群组Owner还可管理群组下的所有子项目、成员和设置
6. Planner（规划者，GitLab 17.7+新增）
- 适用场景：专注于项目管理的产品经理、项目经理，无需代码操作权限。
- 核心权限 ：
- 可管理Issue、Epic、看板、里程碑等项目规划工具
- 可查看代码仓库和CI/CD结果，但无任何读写权限
- 无法推送代码、创建分支或修改项目配置
7. Administrator（管理员，实例级）
- 适用场景：GitLab实例的系统管理员，拥有整个平台的最高权限。
- 核心权限 ：
- 可访问和修改所有项目、群组、用户的配置
- 可管理系统设置、用户账户、许可证、备份与恢复
- 可绕过项目级别的权限限制，查看所有私有项目内容
💡 关键补充说明
- 权限叠加规则 ：如果用户同时属于项目所在的群组和项目本身，会取两者中更高的角色权限。
- 分支保护的影响：即使是Maintainer/Owner，也可能被管理员设置的分支保护规则限制推送权限（例如禁止所有人直接推送到main分支）。
- 群组与项目角色：Owner角色仅可在群组或项目创建时默认赋予，无法通过项目成员列表直接添加（仅群组Owner可设置子项目的Owner）。
- 权限继承关系：所有角色的权限都是向上兼容的，高权限角色自动包含低权限角色的所有能力。