1. 概述
Git 是一个广泛使用的分布式版本控制系统，它允许开发者在不同机器上协作开发。使用 Git，不同的开发者可以克隆一份仓库，在各自独立的分支中进行开发。
当多人协作开发同一个分支时，每个人都需要频繁同步分支，确保本地分支始终包含最新的远程变更。
在本教程中，我们将学习如何在 Git 中同步本地分支与远程分支。
2. Git 分支概述
Git 中的分支是一个轻量级的指针，指向仓库提交链上的某个特定提交（commit）。例如，我们可以通过 git log --oneline 查看当前分支的提交历史：
$ git log --oneline
8f5d8eb (HEAD -> main) (feature) implementing the account restriction function
2bf2caa (bugfix) fix creation issue
a25e624 (feature) implementing the account activation function
192988a (feature) implementing the account creation function
891f9dc Init
可以看到，当前的 main 分支指向提交 8f5d8eb。
Git 内部通过 .git/refs/heads/ 目录下的文件来维护分支信息，每个分支文件中保存的是该分支指向的提交哈希值。例如查看 main 分支的指向：
$ cat .git/refs/heads/main
8f5d8ebe365abb8d860b0e97d4e0f8d0fb9cec03
Git 中的分支可以分为：
- 本地非追踪分支（Local Non-tracking Branch）
- 远程追踪分支（Remote-Tracking Branch）
- 跟踪分支（Tracking Branch）
我们逐一来看。
2.1. 本地非追踪分支
本地非追踪分支是仅存在于本地、不与任何远程分支关联的分支。也就是说，该分支不会自动与远程同步。
我们可以通过以下命令创建一个本地非追踪分支：
$ git checkout -b feature/authentication-function
Switched to a new branch 'feature/authentication-function'
创建后，这个分支不会自动绑定任何远程分支。
2.2. 远程追踪分支
远程追踪分支是 Git 用于记录远程分支状态的本地引用。这些分支由 Git 自动维护，不能手动修改。
**远程追踪分支的命名格式为 <remote-name>/<branch-name>**，例如：
$ git branch -r
origin/HEAD -> origin/main
origin/feature/authentication-function
origin/main
这类分支主要用于在本地缓存远程分支的状态，方便执行 git fetch、git pull 等操作时快速获取远程信息。
2.3. 跟踪分支
跟踪分支是与远程分支关联的本地分支。创建时可以指定远程分支作为追踪目标，Git 会自动记录这种关系。
使用以下命令创建一个跟踪远程分支的本地分支：
$ git checkout -b hotfix/patch-1 origin/hotfix/patch-1
Switched to a new branch 'hotfix/patch-1'
branch 'hotfix/patch-1' set up to track 'origin/hotfix/patch-1'.
创建后，我们可以使用 git status 命令查看本地分支与远程分支的同步状态：
$ git status
On branch hotfix/patch-1
Your branch is behind 'origin/hotfix/patch-1' by 1 commit, and can be fast-forwarded.
(use "git pull" to update your local branch)
nothing to commit, working tree clean
这说明远程分支有更新，本地需要执行 git pull 来同步。
3. 同步本地与远程分支
要同步本地分支与远程分支，主要有两种方式：
✅ 拉取远程变更到本地：使用 git pull
✅ 推送本地变更到远程：使用 git push
3.1. 使用 git pull 更新本地分支
$ git pull
git pull 实际上是 git fetch + git merge 的组合命令：
git fetch：从远程仓库获取最新提交和分支状态git merge：将远程分支的变更合并到当前本地分支
执行后，本地分支将与远程分支保持一致。
3.2. 使用 git push 推送本地变更
$ git push
git push 会将本地分支的新增提交同步到远程分支。但需要注意的是，如果远程分支已有新提交，而本地没有先拉取，会导致推送失败：
$ git push
To /home/user/Projects/baeldung/git-sync-branches/account-service
! [rejected] hotfix/patch-1 -> hotfix/patch-1 (fetch first)
error: failed to push some refs to '/home/user/Projects/baeldung/git-sync-branches/account-service'
hint: Updates were rejected because the remote contains work that you do
...
此时应先执行 git pull 合并后再推送：
$ git pull
Merge made by the 'ort' strategy.
patch-2 | 0
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 patch-2
$ git push
Enumerating objects: 12, done.
...
c2fd749..30f295f hotfix/patch-1 -> hotfix/patch-1
⚠️ 建议流程：
git pull拉取最新远程变更- 本地开发完成后
git add,git commit - 再执行
git push推送至远程
这样可以避免因冲突导致推送失败。
4. 总结
在本教程中，我们了解了 Git 中分支的本质是提交的指针，并介绍了三种常见分支类型：
| 分支类型 | 是否与远程关联 | 是否可手动修改 |
|---|---|---|
| 本地非追踪分支 | ❌ | ✅ |
| 远程追踪分支 | ✅（自动） | ❌ |
| 跟踪分支 | ✅（手动绑定） | ✅ |
最后我们学习了如何使用 git pull 和 git push 实现本地与远程分支的同步。
✅ 最佳实践建议：
- 开发前先
git pull确保本地是最新的 - 推送前务必先拉取合并，避免冲突
- 使用
git status查看当前分支与远程的同步状态
熟练掌握这些操作，可以有效提升 Git 协作效率，避免因分支不同步带来的协作问题。