Gitee 保护分支使用指南：从新建仓库到代码合并全流程

可以通过下面方式查看分支是否受保护：

新建保护分支，选择'代码'→'新建分支'。

配置完成后的效果

1. 任何人都不能直接向 develop 分支推送代码，必须先在个人分支开发，再发起 PR。
2. PR 必须经过指定人数的审查通过，并且 CI 检查通过后，才能由管理员合并。
3. 有效避免未经审核的代码进入主分支。

保存后，主分支仅能通过符合规则的 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 通过、无冲突）：

九、常见问题排查