# 关于upstream

假设learngit是一个本地git仓库，那么当我们在learngit目录下执行git目录时，实际上此时是在某个分支下的（比如master分支）。那么当我们执行如下命令时：

```
$ git push
```

git会把当前分支的内容默认同步到origin远程仓库的同名分支。同理`git pull`命令会从origin的同名分支拉取代码。

**一个分支的upstream，其实就是与远程分支做关联，告诉git，默认此分支为推送及拉取的远程分支的信息。**

## 基本设置

```
$ git branch --set-upstream-to=origin/dev
```

此命令的含义是，是指当前分支的upstream为origin远程仓库的dev分支

## 在push时设置upstream

```
$ git push -u origin master
```

命令的含义是，推送当前分支到远程origin仓库master分支，并且建立本地当前分支的upstream为origin/master

## 取消upstream

```
$ git branch --unset-upstream
```

该命令的意思是，取消本地仓库当前分支的upstream

## 查看upstream

查看upstream信息，主要是查看仓库目录下`.git/config`文件

```
$ cat .git/config
[core]
        repositoryformatversion = 0
        filemode = true
        bare = false
        logallrefupdates = true
[remote "origin"]
        url = git@github0123:jeremy0123/fetch.git
        fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
        remote = origin
        merge = refs/heads/master
[branch "br01"]
        remote = origin
        merge = refs/heads/br01-remote
[branch "br03"]
        remote = origin
        merge = refs/heads/br03
```

其中`[branch "分支名"]`下的信息就是upstream信息，remote项表示upstream的远程仓库名，merge项表示远程跟踪分支名

## Reference

\[1] <https://higoge.github.io/2015/07/06/git-remote03/>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pshizhsysu.gitbook.io/git/yuan-cheng-cang-ku/guan-4e8e60-set-upstream.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.