许多社区,无论是在GitHub上还是在更广泛的Git社区中,都在考虑将其存储库的默认分支名称从master重命名。GitHub正在逐步将我们自己存储库的默认分支从master重命名为main。我们致力于为项目维护人员及其所有贡献者提供尽可能无缝的重命名过程。此存储库是我们关于如何以及何时重命名默认分支的最新指导。
我们并不是Git生态系统中唯一做出这些改变的组织:在Git项目中有即将到来的改变(声明、代码改变),以及来自多个供应商的协调改变。
我们正在分几个阶段对GitHub进行修改,旨在尽可能减少对现有项目的破坏。
如果您还没有重命名您的默认分支,请考虑等到今年晚些时候。我们正在投资工具,使重命名现有存储库的默认分支成为维护人员和贡献者的无缝体验。
我们更新了GitHub.com,将包含已删除分支名称master的链接重定向到存储库新的默认分支中的相应链接。
我们已经更新了GitHub页面,以便从任何分支机构构建和部署。注意:发布到特殊的gh-Pages分支仍将一如既往地工作,但现在您可以选择存储库中的任何其他分支作为发布源。
我们已经添加了用户、组织和企业设置,以便为GitHub.com上所有新创建的存储库设置默认分支机构名称。这些设置涵盖通过GitHub.com和GitHub API创建的存储库。Git2.28添加了类似的设置来控制在命令行上运行git init时使用的默认分支。在Git2.28博客文章中了解有关新的init.defaultBranch设置的更多信息。
本月晚些时候,GitHub Desktop还将为新存储库引入默认分支设置。
在2020年10月1日,您创建的任何新存储库都将使用main作为默认分支,而不是master。此更改不会影响任何现有存储库:现有存储库将继续具有与现在相同的默认分支。
您可以随时选择退出此更改。要选择退出,请为您的用户、组织或企业设置新资料库的默认分支:
Main是我们在GitHub上看到的最受欢迎的MASTER替代品。我们喜欢它,因为它很短,它能保持你的肌肉记忆完好无损,而且它能很好地翻译成大多数语言。我们将Main用于我们新创建的存储库和我们现在移动的存储库,如Dependabot-core。
到今年年底,我们将使现有的存储库可以无缝地重命名其默认分支。当您重命名分支机构时,我们将重新定位您的开放PR和草稿版本,移动您的分支机构保护策略,等等-所有这些都是自动完成的。此外,我们还在研究如何将git获取或git克隆旧分支名称的用户重定向到新分支名称(带有更新其本地克隆的警告和说明),以便您的贡献者可以轻松移动。