Ubuntu 24.04下Git仓库移除master分支仅保留main分支求助

问题分析 #

你执行git pull origin master --allow-unrelated-histories时报错，核心原因是远程仓库的master分支可能已被删除，或是本地缓存的远程分支引用未更新——虽然git branch -a显示有remotes/origin/master，但这大概率是本地留存的旧引用。另外你的操作逻辑存在偏差：要把master的内容整合到main，直接合并本地master分支即可，无需从远程拉取。

正确操作步骤 #

1. 确保main分支包含master的所有内容 #

当前你已处于main分支（* main），直接合并本地master分支：

git merge master

如果出现冲突，手动解决冲突后执行git add .和git commit完成合并。

2. 更新本地远程分支引用 #

清理本地缓存的无效远程分支引用，确保和远程仓库状态一致：

git fetch origin --prune

执行后，本地的remotes/origin/master会被移除（如果远程确实已删除该分支）。

3. 删除本地master分支 #

确认main已包含master的所有内容后，删除本地master分支：

git branch -d master

如果Git提示分支未合并（说明你漏了合并步骤），可以用-D强制删除：

git branch -D master

4. 删除远程master分支 #

将远程仓库的master分支彻底删除：

git push origin --delete master

5. 清理旧分支配置 #

你的Git配置中还残留branch.master的相关设置，执行以下命令移除：

git config --unset branch.master.remote
git config --unset branch.master.merge

后续验证 #

执行以下命令确认所有操作完成：

# 查看本地分支，应只有main
git branch
# 查看远程分支，应只有main
git branch -r

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