git branch -vv 是查看所有本地分支 upstream 信息的最直接方式，显示跟踪的远程分支及提交偏移状态，方括号为空表示未设置 upstream，且 remote 名（如 origin/upstream）依实际配置而定。

git branch -vv 能直接看到所有本地分支的 upstream 信息

这是最直接、无需额外配置的方式。git branch -vv 会列出所有本地分支，并在括号里显示其跟踪的远程分支（即 upstream），以及本地与远程的提交偏移状态。比如：

  main       [origin/main] Merge pull request #123
* dev        [origin/dev] Add user auth logic
  feature/x  [upstream/feature-x] WIP on search filter

注意：[origin/dev] 中的 origin/dev 就是当前分支 dev 的 upstream 分支；方括号为空（如 dev []）表示未设置 upstream。

常见误区：只用 git branch（不带 -v）看不到 upstream，必须加 -v 或 -vv。

VSCode 内置 Git 视图默认不显示 upstream，需靠命令补全

VSCode 左侧 Git 面板只显示本地分支名和图标，不展示远程跟踪关系。它依赖底层 Git 的配置来切换推送/拉取目标，但不渲染 upstream 字符串。

如果你希望在 VSCode 界面中“一眼看出”关联关系，只能：

• 右键某个分支 → 选择 Copy Branch Name，然后手动在终端运行 git config --get branch.<branch-name>.merge</branch-name> 和 git config --get branch.<branch-name>.remote</branch-name>
• 或更简单：打开 VSCode 集成终端，直接执行 git branch -vv

别指望点击几下就能在 UI 里查到——这不是 VSCode 的设计逻辑，它把这类元信息交给 Git 命令层处理。

上游分支没设置？git branch --set-upstream-to 是唯一可靠写法

新分支默认没有 upstream，除非你用 git checkout -b foo origin/foo 或 git switch -c foo --track origin/foo 创建。如果漏了，就会出现 git push 报错：fatal: The current branch xxx has no upstream branch.

windows-git-ops

在 Windows PowerShell 工作区执行 Git 操作时使用此技能，特别适用于创建分支、暂存、提交、合并、状态检查等。

下载

修复方式只有这一种标准写法（Git 2.0+）：

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

注意：--set-upstream 已废弃，不要用；origin/dev 必须存在且可访问；目标分支名（dev）可以省略，若当前就在该分支上。

设完再跑一遍 git branch -vv 就能确认是否生效。

远程名（remote name）不是固定的，origin 可能是 upstream 或 fork

upstream 分支的完整标识是 <remote-name>/<branch-name></branch-name></remote-name>，而 remote-name 完全由你自己定义。很多人以为一定是 origin，其实：

• 你 fork 项目后添加原仓库为远程，常命名为 upstream：git remote add upstream https://github.com/original/repo.git
• 此时你的 main 分支 upstream 很可能是 upstream/main，而非 origin/main
• git branch -vv 显示的正是这个真实 remote 名，不会自动映射或猜测

所以看到 [upstream/main] 别慌，说明你确实配置对了——只是 remote 名不是 origin 而已。

真正容易被忽略的是：upstream 关系是分支粒度的，不是仓库全局的。一个 repo 可以有多个 remote，每个本地分支可以各自指向不同 remote 的不同分支，git branch -vv 是唯一能一次性看清全部映射的地方。