为何WSL Ubuntu的Git默认分支为Master？如何修改为Main？

全局设置（所有新仓库生效） #

在WSL Ubuntu终端中执行以下命令，设置Git全局默认分支为main：

git config --global init.defaultBranch main

验证设置是否成功：

git config --global --get init.defaultBranch

如果输出main，说明全局配置已生效，之后新创建的Git仓库默认分支都会是main。

修改现有仓库的分支名称 #

如果是已经创建好的仓库，需要手动将master分支重命名为main：

1. 切换到目标仓库的master分支：

git checkout master

2. 重命名本地分支：

git branch -m main

3. 将重命名后的分支推送到远程仓库，并设置跟踪关系：

git push -u origin main

4. 删除远程仓库的master分支（如果不需要保留）：

git push origin --delete master

可能的问题排查 #

如果之前尝试的方法没生效，大概率是这几个原因：

• 误在Windows终端而非WSL Ubuntu终端执行了配置命令：WSL的Git配置和Windows系统的Git是独立的，必须在WSL终端内操作。
• 仅修改了本地分支但未同步到远程：需要完成推送和删除远程旧分支的步骤，才能让远程仓库默认分支同步变更。
• 全局配置未正确生效：可以直接查看Git全局配置文件确认，路径为~/.gitconfig，检查是否包含[init]段且defaultBranch = main。

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