GitHub新手推送文件至master分支而非main分支问题咨询及使用建议求助

问题影响说明 #

该情况本身不会损坏Git仓库的存储内容，但会带来实际使用层面的不便：

1. 访客进入仓库默认展示main分支，会误认为仓库没有上传项目代码
2. 后续如果配置GitHub Actions、Pages等内置服务，默认会读取main分支内容，会出现配置失效的问题
3. 目前GitHub新建仓库的默认主分支统一为main，master属于Git早期的默认分支命名，不符合当前社区通用使用习惯，协作时会增加额外的沟通成本

修复步骤 #

你可以通过以下操作把项目内容合并到main分支，对齐使用规范：

1. 本地仓库切换到main分支：
   git checkout main
2. 合并master分支的全部内容到main分支：
   git merge master
   如果出现文件冲突，手动修改冲突文件后执行git add 冲突文件名，再执行git commit完成合并即可
3. 把合并后的main分支推送到远程仓库：
   git push origin main
4. 进入GitHub仓库的「Settings」-「Branches」页面，把默认分支修改为main，后续访客打开仓库就会直接展示项目内容
5. 不需要保留master分支的话可以执行命令删除：
   远程删除：git push origin --delete master
   本地删除：git branch -d master

如果要从根源避免后续新建仓库再出现该问题，可以执行全局配置，设置Git新建仓库的默认分支为main：
git config --global init.defaultBranch main

新手使用建议 #

• 每次执行推送操作前，先运行git branch确认当前所在分支，带*标记的为当前分支，避免推错分支
• 提交代码前先运行git pull origin 对应分支名拉取远程最新代码，大幅降低冲突出现的概率
• 提交信息尽量描述清楚本次修改的内容，不要使用「更新」「修改」这类模糊表述，方便后续回溯修改历史
• 提前配置仓库的.gitignore文件，过滤不需要上传的本地配置、敏感凭证、依赖缓存等内容，避免误提交敏感信息
• 多人协作的项目不要直接向主分支提交代码，建议新建独立的功能分支开发，完成后提交Pull Request合并到主分支，方便代码审核和问题追溯

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