一、新建仓库
- 仓库名称 / 路径：按项目命名，如
my-project。 - 可见性：私有（团队项目推荐）/ 公开。
- 初始化：勾选 README、添加
.gitignore（按语言选）、可选开源许可证。
点击'创建'，完成仓库初始化。
登录 Gitee → 右上角'+'→'新建仓库'。
二、仓库成员与权限配置
输入成员 Gitee 空间 / 邮箱地址，分配角色：
| 角色 | 查看代码 | 提交 Issues | 提交代码 / PR | 合并 PR | 修改仓库设置 |
|---|---|---|---|---|---|
| 管理员 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 开发者 | ✅ | ✅ | ✅ | ❌ | ❌ |
| 报告者 | ✅ | ✅ | ❌ | ❌ | ❌ |
| 观察者 | ✅ | ❌ | ❌ | ❌ | ❌ |
进入仓库 → 顶部'管理'→ 左侧'成员管理'→'添加成员'。
保存后，成员将收到邀请，接受后即可参与协作。
三、配置保护分支
仓库'管理'→ 左侧'保护分支设置'→'编辑'，启用核心限制：
设置分支名称（如 main/develop）→'保护分支'。
可以通过下面方式查看分支是否受保护：
新建保护分支，选择'代码'→'新建分支'。
| 配置项 | 推荐值 | 具体含义 |
|---|---|---|
| 设置分支/通配符 | develop | 指定这条保护规则仅对名为 develop 的分支生效；若需保护多分支，可用通配符（如 develop-*） |
| 规则白名单 | 留空 | 允许某些符合匹配规则的分支不受保护，可添加例外分支 |
| 权重 | 1 | 当存在多条保护规则时，权重数值越大的规则越优先匹配 |
| 可推送代码成员 | 无 | 禁止任何角色直接向 develop 分支推送代码 |
| 可合并 Pull Request 成员 | 仓库管理员 | 仅仓库管理员有权限点击「合并」按钮，将 PR 合并到 develop |
| 要求门禁状态成功才能合并 | ✅ 勾选 | PR 必须通过预设的 CI 检查（如单元测试、代码规范扫描）后，才能被合并（前期不建议开启，项目稳定后建议开启） |
| 模式 | 评审模式 | 强制 PR 必须经过指定人数的审查批准，才能满足合并条件 |
配置完成后的效果
- 任何人都不能直接向
develop分支推送代码，必须先在个人分支开发，再发起 PR。- PR 必须经过指定人数的审查通过，并且 CI 检查通过后，才能由管理员合并。
- 有效避免未经审核的代码进入主分支。
保存后，主分支仅能通过符合规则的 PR 合并，禁止直接推送。
四、设置代码审查规则
- 审核人员：选择默认评审者（可多选），PR 创建时自动指派。
- 测试人员：按需添加，用于需测试验证的场景。
配置审核 / 测试人员：
仓库'管理'→ 左侧'代码审查设置'→'配置'。
保存后，PR 将自动触发通知与规则校验。
五、测试：禁止直接推送
注意：需要先拉取代码到本地
- 测试：验证「禁止直接推送到保护分支（develop）」
- 核心目的：确认配置的「可推送代码成员 = 无」生效，无法直接向 develop 分支推送代码。
用 账号 A（管理员账号） 在本地操作：
# 1. 切换到 develop 分支并拉取最新代码
git checkout develop
git pull origin develop
# 2. 随意修改一个文件（如 README.md），添加一行测试内容
# 3. 提交并尝试直接推送到远程 develop 分支
git add .
git commit -m "test: 尝试直接推送 develop 分支"
git push origin develop
验证预期结果：
remote: Cannot push to a protected branch 'refs/heads/develop' directly
六、开发者流程：提交代码与创建 PR
- 仓库主页 →'Pull Request'→'新建 PR'。
- 源分支：选择前面新建的个人分支；目标分支：
develop。 - 填写 PR 标题 / 描述（建议含变更目的、测试结果），提交 PR。
- 若未完成开发，可标记为'草稿 PR'，避免误审核。
Gitee 网页端创建 PR：
可视化操作（仅以 PyCharm 作为示例）：
命令操作（不习惯用命令的可以通过可视化界面操作完成）：
# 克隆仓库
git clone https://gitee.com/你的用户名/你的仓库名.git
cd 你的仓库名
# 创建一个自己提交代码的分支「新建分支 + 立即切换到该分支」的组合命令
git checkout -b 分支名
# 开发并提交代码
git add .
git commit -m "推送代码到个人分支"
# 推送到远程个人分支
git push origin 分支名
七、审查者流程：审核 PR 与批准 / 驳回
- 查看代码修改、提交说明、添加行内评论（指出问题 / 建议）。
- 检查逻辑漏洞、代码规范、性能影响、测试覆盖。
- 批准：无问题时点击'审查通过'，满足门槛后允许合并。
- 请求变更：需修改时标注问题，开发者修改后重新提交。
操作选项：
收到通知后，进入 PR 页面：
八、合并 PR 与收尾
- 管理员 / 有权限成员点击'合并分支'，可根据场景选择合并方式。
- 合并后：
- 删除源分支（可选，保持仓库分支整洁，也可以在项目结束统一删除）。
- 通知团队，主分支已更新，其他开发者拉取最新代码。
当 PR 满足所有条件（审查通过、CI 通过、无冲突）：
九、常见问题排查
| 问题 | 解决方法 |
|---|---|
| PR 不触发审查 | 检查保护分支是否勾选'合并前必须审查' |
| 审查者未收到通知 | 在'代码审查设置'中添加默认审核人员 |
| 可直接推送到主分支 | 重新配置保护分支，启用'禁止任何人直接推送' |