remote-tracking branch（如origin/main）是本地只读引用，存于.git/refs/remotes/origin/下，仅缓存远程分支最新commit的sha1，由git fetch等网络操作自动更新，非实时状态，也不可直接checkout或修改。

remote-tracking branch 本质是只读的本地引用

remote-tracking branch（比如 origin/master）不是远程仓库的“副本”，也不是某种特殊分支类型，它就是一个普通的、**只读的本地引用**，存放在 .git/refs/remotes/origin/master 文件里，内容只是某个 commit 的 SHA1 哈希值。Git 不允许你直接 git checkout origin/master 或 git reset --hard origin/master（会报错），因为它被设计为反映远程状态的“快照”，而非工作分支。

它更新的唯一方式是 Git 自动操作：每次执行 git fetch、git pull 或 git remote update 时，Git 从远程拉取新对象后，会重写这个文件，把 origin/master 指向远程 master 当前最新的 commit。

• 手动修改 .git/refs/remotes/origin/master 文件内容会导致 Git 认为远程状态“不一致”，后续 git status 可能误报 ahead/behind
• git fetch --prune 会删除已不存在于远程的 remote-tracking branch（如远程删了 feature-foo，本地 origin/feature-foo 就会被清理）
• 它不参与 merge/rebase 的默认目标选择——git merge 不带参数时不会去合并 origin/master

为什么 git branch -r 显示的不是远程分支本身

git branch -r 列出的是你本地已知的所有 remote-tracking branch，不是实时查询远程仓库。这些引用只在你最近一次 git fetch 后存在且有效。如果远程 master 已被他人推进了 3 个 commit，而你没 fetch 过，origin/master 仍指向旧 commit，git branch -r 就显示那个旧状态。

换句话说：git branch -r 是“你本地缓存的远程视图”，不是“远程当前视图”。它和 git ls-remote origin master 返回的结果可能完全不同。

GitHub Iteration Workflow

GitHub Issue 全流程自动化：自动拉取、修复 Issue，创建 PR，监控 CI/CD，合并部署。

下载

• git ls-remote origin master 直接连远程服务器查 HEAD，返回 raw SHA1，不依赖本地任何引用
• git remote show origin 会先 fetch 元信息再展示，比 branch -r 更准，但仍有短暂延迟
• 没有网络时 git branch -r 仍能输出，因为它读的是本地文件；git ls-remote 则直接失败

git pull 和 git fetch 对 remote-tracking branch 的影响差异

git fetch 只做一件事：下载远程新对象 + 更新所有对应的 remote-tracking branch（如 origin/master、origin/dev）。它不碰你的工作区、不改 HEAD、不自动 merge。

git pull = git fetch + 默认 git merge FETCH_HEAD（或 rebase，取决于配置）。关键点在于：merge 目标不是 origin/master，而是 FETCH_HEAD —— 后者是 fetch 过程中临时记录的、刚拉下来的远程分支 tip 的 SHA1。

• 如果你在 fetch 后手动改过 origin/master 文件（不推荐），git pull 仍以 FETCH_HEAD 为准，不受篡改影响
• git pull origin main 会先 fetch origin/main 并更新 origin/main 引用，再 merge 它——这时才真正用到 remote-tracking branch
• git pull --rebase 也是先 fetch 更新 origin/main，再 rebase 当前分支 onto origin/main

remote-tracking branch 和 upstream 设置不是一回事

很多人混淆 origin/master（remote-tracking branch）和 “当前分支的 upstream”（比如 master 分支的 upstream 是 origin/master）。前者是独立存在的只读引用；后者是分支自身的配置项，存于 .git/config 中，形如：

[branch "master"]
    remote = origin
    merge = refs/heads/master

这个配置决定了 git push、git pull、git status 等命令的默认行为。但即使你删掉这个 upstream 配置，origin/master 依然存在、依然被 fetch 更新。

• git branch -u origin/dev 是设置当前分支的 upstream，不是“创建” origin/dev —— 后者早已存在（只要 fetch 过）
• git branch --unset-upstream 只清配置，不影响 origin/dev 引用本身
• 没有 upstream 的分支，git push 第一次会报错，必须显式指定 git push -u origin branchname

remote-tracking branch 看似简单，但它横跨 fetch/pull/push 三类操作，又和 upstream、HEAD、工作区状态耦合紧密。最容易忽略的是：它不主动刷新，也不参与工作流决策——所有“智能行为”都依赖你是否及时 fetch，以及分支是否设置了正确的 upstream。