VSCode WSL终端中Git init无法将默认分支设为main的问题

核心原因 #

Git的init.defaultBranch全局配置项是2.28版本才正式引入的，你的Git版本是2.25.1，这个版本不识别该配置，所以之前的全局设置不会生效。

解决办法 #

1. 修改已初始化仓库的分支名

如果已经执行了git init，直接重命名现有分支即可：

git branch -m master main

2. 配置模板让新仓库默认用main分支

想要让后续所有git init的仓库都默认使用main分支，可通过Git初始化模板实现：

• 创建模板目录结构：

  mkdir -p ~/.git-template/refs/heads
  

• 在模板中创建main分支的引用文件：

  touch ~/.git-template/refs/heads/main
  

• 全局配置Git使用该模板：

  git config --global init.templateDir ~/.git-template
  

  之后执行git init时，默认分支就会是main。

3. 升级Git版本（可选）

如果条件允许，把Git升级到2.28及以上版本，你之前配置的init.defaultBranch = main就会自动生效。

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