只需运行git config --global init.defaultbranch main，即可使后续所有git init新建仓库默认使用main分支；该配置不影响已有项目，且与github/gitlab等平台默认保持一致。

macos 上配置 git 默认分支名为 main（而非旧版的 master），只需一条命令，且推荐在安装 git 后第一时间设置。

直接设置默认初始分支名

在终端中运行：

git config --global init.defaultBranch main

执行后，今后所有新初始化的仓库（git init）都会自动创建 main 分支，无需手动重命名或额外操作。

验证是否生效

运行以下命令查看当前全局配置：

fastgithub

提供本地代理服务器以加速 GitHub 访问，显著提升 Linux、macOS、Windows 下克隆、推送和下载的速度。

下载

git config --global --get init.defaultBranch

如果输出 main，说明已成功配置。也可以用 git config --global -l 查看全部全局设置，确认其中包含 init.defaultBranch=main。

注意兼容性和已有项目

• 该设置只影响后续新建的仓库，不影响已存在的项目分支结构
• GitHub、GitLab 等平台已默认使用 main，保持一致可避免推送时出错（如提示 src refspec master does not match any）
• 若团队协作中仍需支持 master，不建议修改此项；但个人开发或新项目强烈推荐使用 main

顺便完成基础身份配置（推荐一并设置）

为确保每次提交能正确显示作者信息，建议同步配置用户名和邮箱：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

这三行命令（分支名 + 姓名 + 邮箱）构成了 macOS 上 Git 的最小可用配置组合。