Reset local repository branch to be just like remote repository HEAD

技术背景

在使用 Git 进行版本控制时，有时会遇到本地分支与远程分支不一致的情况。可能是因为误操作、多人协作时远程分支被更新等原因。这时就需要将本地分支重置为与远程分支的 HEAD 一致，以保证本地代码与远程仓库的最新状态同步。

实现步骤

保存当前工作

如果想在重置之前保存当前分支的状态，可以使用以下命令：

git commit -a -m "Saving my work, just in case"
git branch my-saved-work

重置本地分支到远程分支

方法一：指定远程仓库和分支名

git fetch origin
git reset --hard origin/master

此方法假设远程仓库名为 origin，且远程仓库的 master 分支与本地当前检出的分支对应。

方法二：使用 @{u} 或 @{upstream}

git reset --hard @{u}

这种方法的优点是无需显式指定远程仓库和分支的名称。在 Windows 或使用 PowerShell 时，需指定 "@{u}"（带双引号）。

移除未跟踪的文件

git clean -df

如果需要移除 .gitignore 中的文件，可以使用：

git clean -x -d -f

注意：git clean -x -d -f 是不可逆操作，可能会丢失文件和数据。

获取最新更改

git pull

核心代码

以下是一个自动化脚本，用于将当前分支重置为远程分支：

#!/bin/bash
# reset the current repository
# WF 2012-10-15
# AT 2012-11-09
# see http://stackoverflow.com/questions/1628088/how-to-reset-my-local-repository-to-be-just-like-the-remote-repository-head
timestamp=`date "+%Y-%m-%d-%H_%M_%S"`
branchname=`git rev-parse --symbolic-full-name --abbrev-ref HEAD`
read -p "Reset branch $branchname to origin (y/n)? "
[ "$REPLY" != "y" ] || 
echo "about to auto-commit any changes"
git commit -a -m "auto commit at $timestamp"
if [ $? -eq 0 ]
then
  echo "Creating backup auto-save branch: auto-save-$branchname-at-$timestamp"
  git branch "auto-save-$branchname-at-$timestamp" 
fi
echo "now resetting to origin/$branchname"
git fetch origin
git reset --hard origin/$branchname

最佳实践

• 在进行重置操作之前，先保存当前的工作状态，以免丢失重要更改。
• 尽量避免直接向非裸仓库的当前检出分支进行推送操作，建议切换到其他分支进行更改并推送。
• 使用 git status 命令确认工作目录是否干净。

常见问题

误操作提交了不需要的提交

如果已经提交了一些不需要的更改，可以使用 git reset --hard HEAD~n 命令回退 n 个提交。例如，回退 2 个提交：

git reset --hard HEAD~2

注意：此操作会丢失所做的更改，请谨慎使用。

非当前检出分支的重置

如果要重置的分支不是当前检出的分支，可以使用 git update-ref 命令：

git update-ref refs/heads/mybranch myremote/mybranch

此方法不会影响当前检出的分支和工作树，只是将 mybranch 的 HEAD 移动到指定的提交。但使用时需谨慎，建议使用 gitk 等工具进行确认。