远程分支跟踪

跟踪分支（Tracking Branch）是本地分支与远程分支的关联关系。

什么是跟踪分支

跟踪分支设置了上游（upstream）远程分支，使得：

• git push 自动推送到对应远程分支
• git pull 自动从对应远程分支拉取
• git status 显示与远程分支的差异

远程分支命名

远程分支格式：<remote>/<branch>
例如：origin/main, origin/feature

设置跟踪分支

# 方法1：推送时设置（推荐）
git push -u origin feature
git push --set-upstream origin feature

# 方法2：创建分支时设置
git checkout -b feature origin/feature
git checkout --track origin/feature

# 方法3：已有分支设置上游
git branch -u origin/feature
git branch --set-upstream-to=origin/feature

查看跟踪关系

# 查看分支详细信息
git branch -vv

# 输出示例
  feature    a1b2c3d [origin/feature] 添加新功能
* main       b2c3d4e [origin/main] 主分支

# 查看远程分支
git branch -r

跟踪分支示例

# 创建跟踪分支
$ git checkout -b feature origin/feature
Branch 'feature' set up to track remote branch 'feature' from 'origin'.
Switched to a new branch 'feature'

# 查看状态
$ git status
On branch feature
Your branch is up to date with 'origin/feature'.

常用操作

跟踪分支的好处

无跟踪分支：
git push origin feature
git pull origin feature

有跟踪分支：
git push
git pull

修改跟踪关系

# 修改上游分支
git branch -u origin/new-feature feature

# 取消跟踪
git branch --unset-upstream feature

克隆时自动跟踪

# 克隆仓库时自动创建跟踪
git clone <url>
# main 分支自动跟踪 origin/main

# 克隆后创建其他跟踪分支
git checkout -b dev origin/dev

查看与远程的差异

# 本地领先远程
$ git status
Your branch is ahead of 'origin/main' by 2 commits.

# 本地落后远程
$ git status
Your branch is behind 'origin/main' by 3 commits.

# 本地与远程分叉
$ git status
Your branch and 'origin/main' have diverged.

设置跟踪分支后，push/pull 操作更简便。

要点总结

1. 跟踪分支建立本地与远程的关联
2. -u 或 --set-upstream 设置上游分支
3. git branch -vv 查看跟踪关系
4. 有跟踪分支时 push/pull 无需指定远程
5. 克隆时自动设置 main 分支跟踪