Git拉取报错：远程无master分支，克隆失败求助

在master分支执行git pull时收到报错：

Your configuration specifies to merge with the ref 'refs/heads/master'
from the remote, but no such ref was fetched.

尝试过以下操作但无效：

• git reset --soft HEAD
• git branch --unset-upstream 搭配 git pull --set-upstream-to=origin/correct-branch-name（以及git pull --set-upstream origin master）

远程仓库仅有三个分支，后续执行命令得到以下输出：

$ git branch -r
  origin/HEAD -> origin/master
  origin/added_RGB_led
  origin/button_features
  origin/master
]$ git fetch --prune origin
fatal: 'origin' does not appear to be a git repository
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

权限配置正确，但执行git ls-remote origin同样报错：

$ git ls-remote origin
fatal: 'origin' does not appear to be a git repository
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

尝试重新克隆仓库也失败：

$ git clone git@github.com:organisation/Repo.git
Cloning into 'Repo'...
remote: Enumerating objects: 193, done.
remote: Counting objects: 100% (193/193), done.
remote: Compressing objects: 100% (107/107), done.
remote: Total 193 (delta 62), reused 175 (delta 45), pack-reused 0
Receiving objects: 100% (193/193), 41.66 KiB | 804.00 KiB/s, done.
Resolving deltas: 100% (62/62), done.
fatal: bad object refs/heads/master
fatal: remote did not send all necessary objects
$ cd Repo/
$ git status
fatal: not a git repository (or any parent up to mount point /home/user)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).

1. 检查本地仓库完整性 #

从克隆报错fatal: bad object refs/heads/master来看，远程master分支可能存在数据损坏，或本地克隆路径有文件系统问题。

• 删除现有损坏的仓库目录，换一个全新的本地路径重新尝试克隆
• 克隆前检查目标路径的读写权限，确保无文件锁定或权限限制

2. 修复远程仓库分支（管理员权限） #

如果是仓库管理员，登录GitHub操作：

• 确认master分支是否存在，若已损坏，基于现有可用分支（如added_RGB_led）重新创建master分支
• 进入仓库设置页面，检查是否有Git数据损坏提示，使用GitHub内置的仓库修复工具（若提供）

3. 临时绕过问题，拉取可用分支 #

暂时无法修复远程master分支时，可直接拉取其他正常分支并重建master：

# 克隆指定可用分支
git clone -b added_RGB_led git@github.com:organisation/Repo.git

# 进入仓库后创建并推送master分支
cd Repo
git checkout -b master
git push -u origin master

4. 验证SSH密钥配置 #

重新确认SSH密钥是否正常：

ssh -T git@github.com

若返回成功提示则密钥无问题；否则重新生成SSH密钥并添加到GitHub账户。

5. 切换HTTPS协议克隆 #

如果SSH方式克隆异常，尝试HTTPS协议：

git clone https://github.com/organisation/Repo.git

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