【git】通过配置 `init.defaultBranch`，自定义 Git 初始化时的默认分支名称，避免使用 `master` 并消除相关的警告提示

Git 会提示你配置一个默认的初始分支名称

git init 提示：使用 ‘master’ 作为初始分支的名称。这个默认分支名称可能会更改。要在新仓库中 提示：配置使用初始分支名，并消除这条警告，请执行： 提示： 提示： git config --global init.defaultBranch <名称> 提示： 提示：除了 ‘master’ 之外，通常选定的名字有 ‘main’、‘trunk’ 和 ‘development’。 提示：可以通过以下命令重命名刚创建的分支： 提示： 提示： git branch -m 已初始化空的 Git 仓库于

你收到的提示是因为 Git 从版本 2.28 开始引入了对默认初始分支名称的配置选项，目的是让用户可以自定义初始分支的名称，而不再强制使用默认的 master。这是为了避免使用可能具有不合适含义的术语，并促进更包容的命名惯例。

原因说明

Git 正在逐步淘汰 master 作为默认分支名称，推荐使用诸如 main、trunk 或 development 等更中性的名称。因此，当你运行 git init 初始化一个新的仓库时，Git 会提示你配置一个默认的初始分支名称，以便未来的默认名称发生变化时，你的工作流程不会受到影响。

解决方法

1. 配置全局默认初始分支名称

你可以通过以下命令全局设置一个你偏好的初始分支名称，例如 main：

git config --global init.defaultBranch main

这样，未来你在任何地方运行 git init 时，默认的初始分支都会是 main，而不会再显示警告信息。

2. 为当前仓库设置默认初始分支名称

如果你只想为当前仓库设置初始分支名称，可以省略 --global 选项：

git config init.defaultBranch main

3. 重命名当前分支

如果你已经初始化了仓库，并且当前分支是 master，你可以将其重命名为 main 或其他你选择的名称。例如，将当前分支重命名为 main：

git branch -m main

推荐步骤

1. 设置全局默认分支名称（推荐使用 main）：

   git config --global init.defaultBranch main
   

2. 初始化新的仓库：

   git init
   

   现在，新的仓库默认分支将是 main，而不会显示之前的警告信息。

3. 如果需要重命名已有仓库的分支：

   进入仓库目录后运行：

   git branch -m main
   

其他常见分支名称

除了 main，你还可以选择其他名称作为默认分支，如：

• trunk
• development
• dev

选择一个适合你团队或项目工作流程的名称即可。

总结

通过配置 init.defaultBranch，你可以自定义 Git 初始化时的默认分支名称，避免使用 master 并消除相关的警告提示。这不仅有助于保持一致的工作流程，还体现了对更包容性命名的支持。