克隆Gitee仓库新增Maven模块生成main分支无法使用及.gitignore失效问题

原因 #

目前Gitee新建仓库的默认分支名已经从master改为main。你克隆空仓库时，因为远程没有任何提交记录，本地Git会自动创建一个master分支；后续在IDEA中添加Maven模块的过程中，可能是IDEA的Git工具自动同步了远程默认分支名，或是你本地Git的全局配置默认分支为main，导致本地切换到了main分支。

解决办法 #

1. 先查看本地和远程分支状态：
   在IDEA终端执行：

   git branch -a
   

   确认本地main分支和远程分支的情况。
2. 推送本地main分支到Gitee：
   如果远程还没有main分支，执行以下命令创建并推送：

   git push origin main:main
   

3. （可选）设置main为仓库默认分支：
   登录Gitee仓库页面，进入「分支管理」，将main设置为默认分支即可。
4. （可选）清理无用的master分支：
   本地删除：git branch -D master
   远程删除：git push origin --delete master

原因 #

核心原因是这两个文件在你创建.gitignore之前就已经被Git追踪了。.gitignore仅对未被Git追踪的文件生效，一旦文件被加入Git的索引列表，.gitignore的规则就无法约束它。另外也可能是.gitignore的规则书写错误（比如路径写错），导致匹配不到这两个文件。

解决办法 #

1. 检查.gitignore规则：
   确保根目录的.gitignore文件中包含以下两行：

   mvnw
   mvnw.cmd
   

   不要添加多余的路径前缀，直接写文件名即可匹配根目录下的对应文件。
2. 移除Git对这两个文件的追踪（不会删除本地文件）：
   在终端执行：

   git rm --cached mvnw mvnw.cmd
   

3. 提交并推送修改：

   git add .gitignore
   git commit -m "Fix .gitignore, untrack mvnw files"
   git push
   

   之后这两个文件就不会再出现在提交对话框中了。

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