本地已有多次commit时如何拉取Bitbucket指定历史版本Git项目

git pull 本身做不到拉取指定历史版本——它的作用就是拉取远程对应分支的最新提交，再和本地当前分支做合并/变基，不管你本地有没有已提交的commit，都没法靠pull直接拿到历史节点状态。要拿到Bitbucket上目标分支在最后2次commit、1次merge之前的状态，按下面步骤操作就行，全程不会随便覆盖你本地已有提交。

• 第一步：同步全量远程提交记录
  先执行git fetch origin，这个操作只会把Bitbucket上所有的提交记录、分支信息拉到本地缓存，不会改动你当前工作区、本地分支的任何现有内容，比直接pull安全得多。

• 第二步：定位目标提交的哈希值
  两种找法选一个就行：

  • 直接打开Bitbucket上对应仓库的提交列表页，从分支最新的HEAD位置从新到旧数，跳过最近2个普通提交、再跳过那1个merge提交，进入剩下的那个提交详情页，复制它的commit SHA（40位完整哈希或者7位以上短哈希都能用）
  • 本地执行命令查看远程分支日志：git log --oneline --graph origin/你要操作的分支名，日志里merge提交会显示明显的分叉合并标记，从最顶部最新提交往下数，跳过2个普通提交、1个merge提交，对应行开头的7位短串就是目标哈希。

• 第三步：根据你的实际需求选对应操作

  仅临时查看/测试历史版本，不改动现有开发分支 #

  直接执行git checkout 你拿到的目标commit哈希即可，执行完会处于分离头指针状态，正常读代码、跑调试都不受影响。要回到你之前的本地开发状态，直接切回原分支就行，比如切回main分支执行git checkout main，之前本地做的所有commit都不会丢。
  怕操作失误可以先打个备份分支：git branch backup-temp，就算操作错了切回这个备份分支就能完全恢复。

  要把当前分支永久回退到该历史状态，后续基于这个版本开发 #

  按协作场景选方案：

  • 个人分支/确认没有其他协作者基于后续提交开发：直接硬回退，执行git reset --hard 目标commit哈希，如果要把回退后的状态同步到Bitbucket远程，执行强推git push --force origin 你的分支名即可。
  • 多人协作的公共分支：不要用reset改写历史，用revert生成反向提交抵消改动，不会影响其他协作者。注意要从新到旧依次撤销提交，撤销merge提交需要加-m 1参数指定主父分支：

    git revert 最新的普通commit哈希
    git revert 次新的普通commit哈希
    git revert -m 1 merge提交的哈希
    

    执行完会生成3个新的撤销提交，代码状态就和目标历史节点完全一致，你本地之前的旧提交也会全部保留，正常执行git push推到远程就行，不需要强推。

内容的提问来源于stack exchange，提问作者Petro Gromovo