Gitea撤销合并请求开发规范

1. 规范适用场景

本规范适用于Gitea远程仓库中，feature分支通过「合并请求（MR/PR）」经审核后合并至develop分支，后续因需求变更等原因，需彻底撤销该次合并的场景。

核心前提：develop分支为受保护分支，禁止本地直接推送、强制回滚及未经审核的直接修改，合并操作仅可通过Gitea网页端合并请求完成。

通过Gitea网页端操作，从develop分支创建专门的撤销分支，分支命名规范为：revert-任务编号-任务说明（例：revert-T20260101001-新增用户登录功能）。

创建完成后，将该revert分支同步至本地，并切换至该分支（本地操作：git checkout 分支名）。

通过Gitea网页端查找目标合并提交，步骤如下：

在本地revert分支下，执行以下命令撤销合并（需替换对应校验和）：

bash 复制代码

git revert -m 1 合并提交的SHA-1校验和

关键说明：

本地撤销操作完成后，将revert分支推送至Gitea远程仓库，命令如下：

bash 复制代码

git push origin revert-任务编号-任务说明

通过Gitea网页端发起新的合并请求，完成撤销操作的最终审核，步骤如下：

进入仓库，点击「新建合并请求」；
配置合并请求参数：
1. 源分支：选择创建的revert分支（revert-任务编号-任务说明）；
2. 目标分支：选择develop分支；
3. 合并请求标题规范：v<版本号> -任务编号-任务说明（撤销合并请求）。例：v1.0.0-T20260101001-新增用户登录功能（撤销合并请求）；
提交合并请求，等待团队审核，审核通过后完成合并。

合并完成后，需确认以下效果，确保撤销操作合规有效：

以下操作会破坏Git历史、引发代码冲突或违反分支保护规则，严禁执行：

撤销合并仅针对「合并请求生成的合并提交」，必须使用git revert -m 1命令，单独使用git revert会报错（因合并提交有两个父提交，Git无法识别回滚方向）；
若撤销后需重新开发该功能，需从develop分支（撤销后状态）重新创建feature分支，避免复用原有feature分支引发冲突；
所有操作需同步告知团队成员，确保团队代码版本一致，避免因本地分支未同步导致冲突。

命令格式	适用场景	是否需加`-m 1`	本规范适配性
`git revert <普通提交的SHA-1校验和>`	撤销单条普通代码提交	否	❌ 不适用
`git revert -m 1 <合并提交的SHA-1校验和>`	撤销合并请求生成的合并提交	是（必须）	✅ 强制使用

合并请求生成的合并提交包含两个父提交：

-m 1 核心作用是指定Git以父1为基准，撤销合并带来的所有改动。