git branch -M main命令中的-M参数是什么含义？

-M 是Git的参数缩写，等价于同时传入 --move 和 --force 两个参数，作用是强制重命名当前所在分支。

具体拆分逻辑如下：

• 小写的 -m（对应 --move）本身就是分支重命名参数，比如执行 git branch -m main 可以把当前分支改名为main，但如果本地仓库已经存在名为main的分支，该命令会直接报错终止执行。
• 大写的 -M 额外叠加了强制生效的逻辑，即使本地已经存在同名的main分支，也会直接覆盖命名规则，强制把当前分支重命名为main，不会抛出分支名冲突的错误。

你在GitHub新建仓库步骤中看到的这条命令，是因为GitHub现在默认远程主分支名为main，而不少旧版本Git本地初始化时默认主分支名还是master，这一步操作就是为了统一本地和远程的主分支命名，避免后续推送代码时出现分支不匹配的问题。

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