如何检查 Git 仓库是否与远程仓库同步

简介

在这个实验中，你将学习如何检查本地 Git 仓库是否与远程仓库同步。我们将探讨一些实用方法，以确定本地分支是最新的、落后于还是领先于远程分支。

本实验将指导你从远程仓库获取更改，并使用 git status 命令评估同步状态。你还将学习如何使用 git log 命令将本地的 HEAD 与远程跟踪分支（@{u}）进行比较，以识别提交历史中的差异。最后，我们将模拟并检查出现分歧的仓库状态，让你全面了解如何识别和处理 Git 中的同步问题。

Skills Graph

获取并检查 Git 状态

在这一步中，你将学习如何从远程仓库获取更改并检查本地仓库的状态。

假设你正在和其他人一起进行一个项目。他们可能会对项目进行更改，并将这些更改保存到一个中央位置（远程仓库）。你需要一种方法将这些更改同步到你自己的项目副本（本地仓库）中。这就是 git fetch 命令发挥作用的地方。

首先，确保你位于项目目录中。打开终端并输入以下命令：

cd ~/project/my-time-machine

现在，让我们模拟一个远程仓库。在实际场景中，这个远程仓库可能位于 GitHub 或 GitLab 等平台上。在本实验中，我们将使用一个本地目录作为“远程仓库”。

git remote add origin ../my-time-machine-remote

这个命令添加了一个名为 origin 的“远程仓库”，它指向当前项目之外的一个目录。

现在，使用 git fetch 命令从这个模拟的远程仓库获取任何更改：

git fetch origin

如果没有新的更改，你可能看不到太多输出，但这个命令已经与远程仓库进行了通信，并下载了任何新的信息，如提交和分支，但没有将它们合并到你当前的分支中。

获取更改后，检查本地仓库的状态是个好习惯，这样可以了解是否有来自远程仓库但尚未合并到本地的更改。

git status

git status 命令的输出会告诉你本地分支是否与远程分支“同步”，或者是否有可拉取的更改。例如，你可能会看到类似以下的输出：

On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean

或者，如果远程仓库有更改：

On branch master
Your branch is behind 'origin/master' by 1 commit, and can be fast-forwarded.
  (use "git pull" to update your local branch)

nothing to commit, working tree clean

理解 git fetch 之后 git status 命令的输出至关重要。它会告诉你本地分支与远程仓库中对应分支之间的关系。这有助于你决定是否需要拉取更改，或者你的本地副本是否已经是最新的。

使用 git log 比较 HEAD 和 @{u}

在这一步中，你将使用 git log 命令来比较本地分支（HEAD）与其上游分支（@{u}）的状态。这是一种在获取更改后直观呈现差异的有效方法。

首先，确保你位于项目目录中：

cd ~/project/my-time-machine

在 Git 中，HEAD 指的是当前分支所指向的提交，它代表了你当前工作的最新提交。@{u}（或 @\{upstream\}）指的是当前本地分支所跟踪的上游分支，通常是你从远程仓库获取更改的对应分支。

要查看本地分支（HEAD）中有但上游分支（@{u}）中没有的提交，可以使用以下命令：

git log HEAD..@{u}

这个命令会显示从 @{u} 可达但从 HEAD 不可达的提交。换句话说，它显示的是远程分支上有但本地分支上还没有的提交。如果没有这样的提交（即本地分支是最新的或领先于远程分支），这个命令将不会产生任何输出。

现在，让我们查看上游分支（@{u}）中有但本地分支（HEAD）中没有的提交。这显示的是本地分支上有但尚未推送到远程的提交。

git log @{u}..HEAD

这个命令会显示从 HEAD 可达但从 @{u} 不可达的提交。如果没有这样的提交（即本地分支是最新的或落后于远程分支），这个命令将不会产生任何输出。

通过使用带有 .. 符号的 git log 命令，你可以轻松比较仓库中两个不同位置的提交历史，例如本地分支和其对应的上游分支。这对于了解本地仓库相对于远程仓库的状态以及准备拉取或推送更改非常有用。

测试分叉的仓库

在这一步中，你将模拟一个场景，即本地仓库和远程仓库都有对方没有的新提交。这种情况被称为“分叉”状态。

首先，确保你位于项目目录中：

cd ~/project/my-time-machine

让我们在本地仓库中创建一个新的提交：

echo "Adding a local change" > local_change.txt
git add local_change.txt
git commit -m "Add a local change"

现在，模拟直接在“远程”仓库中进行一次提交。你将切换到远程目录，进行一次提交，然后再切换回来。

cd ../my-time-machine-remote
echo "Adding a remote change" > remote_change.txt
git add remote_change.txt
git commit -m "Add a remote change"
cd ../my-time-machine

现在，你已经在本地仓库中创建了一个提交，并在模拟的远程仓库中创建了一个单独的提交。此时，你的仓库已经处于分叉状态。

再次使用 git fetch 命令来更新你对远程仓库的了解：

git fetch origin

现在，检查本地仓库的状态：

git status

你应该会看到表明你的分支已经分叉的输出，类似于以下内容：

On branch master
Your branch and 'origin/master' have diverged,
and have 1 and 1 different commits each, respectively.
  (use "git pull" to merge the remote branch into yours)

nothing to commit, working tree clean

这个状态消息告诉你，本地分支（master）和远程跟踪分支（origin/master）自上次同步以来都有了新的提交，各自向前推进了。它甚至建议使用 git pull 命令来合并远程更改。

理解分叉状态很重要，因为这是与他人协作时常见的情况。这意味着在推送自己的更改之前，你需要将远程更改集成到本地分支中。

总结

在本次实验中，你学习了如何检查本地 Git 仓库是否与其远程仓库同步。首先，你模拟了一个远程仓库，并使用 git remote add 命令将其添加到本地项目中。然后，使用 git fetch origin 命令从远程仓库获取更改，但不进行合并，这是一个关键步骤。获取更改后，你使用 git status 命令来确定本地分支相对于远程分支的同步状态，通过观察输出可以得知分支是最新的还是落后的。

你还将进一步探索使用 git log 命令比较本地 HEAD 与远程跟踪分支的方法，并研究仓库分叉的场景，以全面了解仓库同步的情况。