移除upstream远程仓库后git branch仍显示remotes/upstream/master如何清理？

问题场景与操作过程 #

尝试从本地Git仓库移除upstream远程引用，但执行git branch -a时始终显示remotes/upstream/master记录，多次修剪操作无效，具体步骤如下：

1. 从upstream拉取代码失败，决定移除该远程仓库：

git fetch --all
Fetching origin
remote: Enumerating objects: 9, done.
remote: Counting objects: 100% (9/9), done.
remote: Compressing objects: 100% (5/5), done.
remote: Total 9 (delta 4), reused 8 (delta 4), pack-reused 0
Unpacking objects: 100% (9/9), done.
From github.com:dockerstuff/docker-jupyterhub-deploy
   a977d21..7393fc7  master     -> origin/master
Fetching upstream
fatal: couldn't find remote ref refs/heads/master
error: Could not fetch upstream

2. 查看远程仓库列表，确认upstream存在：

$ git remote -v 
origin  git@github.com:dockerstuff/docker-jupyterhub-deploy (fetch)
origin  git@github.com:dockerstuff/docker-jupyterhub-deploy (push)
upstream    https://github.com/jupyterhub/jupyterhub-deploy-docker.git (fetch)
upstream    https://github.com/jupyterhub/jupyterhub-deploy-docker.git (push)

3. 查看所有分支，可见remotes/upstream/master：

$ git branch --all
* master
  remotes/origin/HEAD -> origin/master
  remotes/origin/master
  remotes/upstream/master

4. 执行移除upstream命令：

$ git remote remove upstream

5. 再次查看分支，remotes/upstream/master仍存在：

$ git branch -a 
* master
  remotes/origin/HEAD -> origin/master
  remotes/origin/master
  remotes/upstream/master

6. 尝试拉取并修剪，无效：

$ git fetch -p --all
Fetching origin

7. 确认upstream已移除，但分支记录仍在：

git remote -v
origin  git@github.com:dockerstuff/docker-jupyterhub-deploy (fetch)
origin  git@github.com:dockerstuff/docker-jupyterhub-deploy (push)

8. 尝试修剪upstream失败（因远程已被移除）：

$ git remote prune upstream
fatal: 'upstream' does not appear to be a git repository
fatal: Could not read from remote repository.

9. 修剪origin后问题依旧：

$ git remote prune origin  

git branch -a
* master
  remotes/origin/HEAD -> origin/master
  remotes/origin/master
  remotes/upstream/master

疑问：为什么remotes/upstream/master还存在？如何正确清理该记录？

原因分析 #

git remote remove upstream仅删除本地Git配置中对upstream远程仓库的引用，但已经同步到本地的远程分支记录（存储在.git/refs/remotes/目录下）不会被自动清理。而git fetch -p或git remote prune这类修剪命令，仅对当前存在的远程仓库有效——由于upstream已被移除，这些命令无法识别并处理残留的分支记录。

解决方法 #

方法1：使用Git命令删除远程追踪分支 #

直接通过git branch命令删除对应的远程追踪分支：

# 尝试删除，若分支未合并会提示报错，可改用-D强制删除
git branch -d -r upstream/master

# 强制删除（无需确认）
git branch -D -r upstream/master

参数说明：

• -d：尝试删除分支，仅当分支已合并到当前分支时成功
• -D：强制删除分支，忽略合并状态
• -r：指定操作对象为远程追踪分支

方法2：手动删除本地引用文件 #

Git的远程分支引用实际存储在本地仓库的.git/refs/remotes/目录下，直接删除upstream目录即可彻底清除所有相关记录：

rm -rf .git/refs/remotes/upstream/

验证操作 #

执行上述任一方法后，运行以下命令确认记录已清除：

git branch -a

此时输出应不再包含remotes/upstream/master条目。

内容的提问来源于stack exchange，提问作者Brandt