一、git revert核心概念
代码写错了，想回到过去？如果你是单人开发，git reset或许还能任性一把；但一旦代码已经推送到远程、多人在同一个分支上协作，这时直接修改历史就像在交规里逆行——迟早要出事。而git revert就是那个让你安全掉头、又不破坏交规的操作。
它不会删除或改写任何已有的提交记录，而是生成一个全新的提交，这个新提交的内容恰好“抵消”了目标提交的所有改动。这样一来，历史记录完整保留，团队里每个人都能看到“何时、因何原因撤销了哪段代码”。适用场景很清晰：
- 代码已推送远程仓库（绝对不能修改公共历史）
- 需要保留回退痕迹，方便日后审计追溯
- 多人协作中回退代码，不影响其他人已有的工作成果
二、git revert完整操作步骤（以你的机械臂场景为例）
步骤 1：查看提交历史，找到要撤销的 Commit ID
先通过日志定位目标提交——记住要找的是那个提交的哈希值（通常前7位就够用）。
# 简洁模式，一眼看清提交链git log --oneline# 详情模式，包含作者、时间、完整IDgit log
假设输出长这样（--oneline模式）：
a87b9c0 (HEAD -> main) 优化机械臂J3角度判断逻辑5d6e7f8 初始化机械臂笛卡尔坐标获取9b8a7s6 新增手型切换基础逻辑
现在要撤销的是a87b9c0这个“优化机械臂J3角度判断”的提交。
步骤 2：执行git revert撤销目标提交
基础用法（撤销单个提交）
# 撤销指定提交，Git会自动打开默认编辑器让你填写提交信息git revert a87b9c0
执行后Git会生成一个默认的revert提交信息，比如Revert "优化机械臂J3角度判断逻辑"。你可以照之前约定的规范修改——补充撤销原因、关联工单编号等。修改完成后的操作和vim一样：按Esc退出编辑，输入:wq保存退出。
快速提交（无需打开编辑器）
如果不想手动编辑，直接加-m参数指定完整提交信息：
git revert a87b9c0 -m "revert: 撤销机械臂J3角度判断逻辑的修改 (#123)原因：J3角度范围判断覆盖不全，导致手型误判撤销的提交ID：a87b9c0"
步骤 3：处理 revert 过程中的冲突（常见场景）
如果目标提交修改的代码段和当前工作区的代码有冲突——比如你在撤销前又改了同一行——Git会停下来提示冲突。这时候别慌：
# 查看哪些文件冲突了git status
冲突文件会被标记为both modified。打开文件，你会看到类似这样的标记：
<<<<<<< HEAD# 当前分支的代码elbow_x = shoulder_x + 10 # 现有逻辑=======# 被撤销提交的代码elbow_x = shoulder_x + 5 # 要撤销的逻辑>>>>>>> a87b9c0 (优化机械臂J3角度判断逻辑)
手动清理：保留你需要的正确代码，删掉冲突标记（<<<<<<<、=======、>>>>>>>这三行）。然后标记文件为已解决并完成revert：
git add 冲突文件名.pygit revert --continue
如果中途发现不对劲想放弃这次revert，执行：
git revert --abort
步骤 4：推送 revert 提交到远程仓库
撤销完成后，新生成的revert提交还在本地，需要推送到远程（比如main分支）：
git push origin main
三、进阶场景：撤销多个提交/合并提交
1. 撤销连续的多个提交
如果要撤销a87b9c0到9b8a7s6之间所有提交（注意顺序：旧在前，新在后）：
git revert 9b8a7s6..a87b9c0
2. 撤销合并提交（需指定父节点）
如果要撤销的是一个合并分支的提交，需要加-m参数指定父节点——通常1表示主分支：
git revert 合并提交ID -m 1
四、git revert vs git reset（新手必区分）
| 特性 | git revert | git reset |
|---|---|---|
| 历史记录 | 保留所有提交（新增revert提交） | 删除指定提交后的所有记录 |
| 适用场景 | 已推送的远程代码 | 本地未推送的代码 |
| 团队协作 | 安全（不影响他人） | 危险（会覆盖远程历史） |
| 可追溯性 | 强（能看到撤销过程） | 弱（历史记录被删除） |
总结
git revert是安全的回退方式，核心是生成新提交抵消旧修改，适合已推送的代码。- 核心操作流程：
查看Commit ID → 执行git revert → 处理冲突（如有）→ 推送远程。 - 提交信息要包含「操作类型+撤销原因+目标Commit ID」，便于团队追溯。
