让现有Git分支跟踪远程分支的方法

技术背景

在使用Git进行版本控制时，经常需要让本地分支跟踪远程分支，这样可以方便地进行代码的拉取和推送操作。不同版本的Git提供了不同的命令来实现这一功能。

实现步骤

Git 1.8.0及更高版本

• 若当前分支为foo，要跟踪upstream远程仓库的foo分支，可使用以下命令：

git branch -u upstream/foo

• 若当前分支不是foo，则使用：

git branch -u upstream/foo foo

• 也可以使用更长的命令，与上述两条命令等效：

git branch --set-upstream-to=upstream/foo
git branch --set-upstream-to=upstream/foo foo

Git 1.7.0 - 1.8.0 版本

使用以下命令让本地分支foo跟踪upstream远程仓库的foo分支：

git branch --set-upstream foo upstream/foo

其他情况

• 设置远程仓库并推送：
  • 若还没有设置remote，可使用以下命令添加：

git remote add origin ssh://...

- 配置`master`分支跟踪远程分支：

git config branch.master.remote origin
git config branch.master.merge refs/heads/master

- 推送代码：

git push origin master

• 使用-u选项推送：

git push -u origin branch-name

其等效的长选项为--set-upstream。

• 解决origin不存在foo分支的问题：
  1. 确保origin确实有foo分支。
  2. 确保remote.origin.fetch变量设置为+refs/heads/*:refs/remotes/origin/*：

git config remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*'
git config --get remote.origin.fetch

3. 运行`git fetch -v`：

git fetch -v

4. 成功后，使用`git branch -avv`查看跟踪情况：

git branch -u origin/foo
git branch -avv

核心代码

以下是不同场景下让本地分支跟踪远程分支的核心代码示例：

Git 1.8.0及以上版本

git branch -u upstream/foo

Git 1.7.0 - 1.8.0 版本

git branch --set-upstream foo upstream/foo

设置远程仓库并推送

git remote add origin ssh://...
git config branch.master.remote origin
git config branch.master.merge refs/heads/master
git push origin master

使用-u选项推送

git push -u origin branch-name

最佳实践

• 尽量使用较新的Git版本，新的语法更直观易记。
• 在设置跟踪关系前，先运行git fetch获取远程仓库的最新信息。
• 设置push.default为upstream，避免不必要的合并问题：

git config --global push.default upstream

常见问题

“error: the requested upstream branch ‘origin/foo’ does not exist”

解决方法：

1. 确保origin确实有foo分支。
2. 确保remote.origin.fetch变量设置为+refs/heads/*:refs/remotes/origin/*。
3. 运行git fetch -v更新远程分支信息。

旧版本Git的push.default问题

旧版本Git的push.default默认值为matching，可能会导致意外的合并操作。建议将其设置为upstream：

git config --global push.default upstream