本地Git仓库无法将master分支重命名为main的问题求助

全局默认分支设置（永久解决新仓库问题） #

直接修改Git全局配置，指定所有新初始化仓库的默认分支名为main，不需要每次新建项目后手动重命名。
执行配置命令：

git config --global init.defaultBranch main

配置完成后可执行以下命令验证是否生效，输出main即为配置成功：

git config --get init.defaultBranch

后续所有新执行git init的项目都会默认使用main作为初始分支，不会再生成master分支，也不会遇到重命名报错的问题。

未提交空仓库的分支重命名方法 #

如果已经执行git init生成了master分支、还没有任何提交记录，无法使用git branch -M main重命名的情况下，可以直接新建main分支再删除空的master引用：

# 直接新建并切换到main分支
git checkout -b main
# 删除原有的master分支引用
git branch -D master

该操作不需要先完成提交，不会触发refname refs/heads/master not found报错。

已有提交的仓库适配远程main分支 #

如果本地仓库已经有提交记录，需要推送到GitHub的main分支，可执行以下命令推送并绑定关联：

git push -u origin master:main

推送完成后再执行重命名命令即可：

git branch -M main

报错原因补充：刚执行完git init的空仓库没有任何提交记录，此时master只是预定义的分支名，还没有生成对应的Git引用文件，因此重命名命令找不到对应的分支对象就会触发报错。

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