本地初始化用 git init -b main 创建 main 分支，已有仓库需重命名本地分支、推送并手动设置远程默认分支为 main，同时全局配置 git config --global init.defaultbranch main 可使新仓库默认使用 main。

直接改就行，但必须分清「本地初始化」和「已有仓库」两种情况，否则远程推送会失败或默认分支不生效。

git init 新建仓库时直接用 main

Git 2.28+ 支持 git init -b main，一步到位创建带 main 分支的新仓库。这条命令会跳过默认的 master，避免后续重命名和推送冲突。

• 如果已执行过 git init 且当前是 master 分支，别急着删分支——先确认没人在用这个仓库，再继续下一步
• git init -b main 不影响已有配置，只作用于本次初始化
• 该命令在 CI/CD 脚本里也安全，无需额外判断分支是否存在

已有仓库从 master 切到 main（含远程同步）

这不是单纯改个名字的事：本地分支名、远程默认分支、CI/CD 工具识别的分支三者必须一致，否则部署脚本可能拉错代码。

alfred-github-backup

GitHub 仓库备份技能 - 将 OpenClaw 工作空间自动或手动备份至 GitHub 私有仓库。支持自动定时备份和手动交互式配置，引导完成 Token 配置、仓库创建、首次备份及定时任务设置。用途：(1) 首次设置 (2) 日常备份。

下载

• 先确保当前在 master 分支：git checkout master
• 重命名本地分支：git branch -m master main
• 推送到远程并设置上游：git push -u origin main
• 登录 GitHub/GitLab，在 Settings → Branches → Default branch 中手动选 main 并保存
• 删掉远程旧分支（可选，但建议）：git push origin --delete master

全局配置让所有新仓库默认用 main

运行 git config --global init.defaultBranch main 后，以后所有 git init 都自动创建 main 分支。这个配置只影响新建仓库，不影响已有项目。

• 检查是否生效：git config --global init.defaultBranch 应输出 main
• 如果团队共用同一套开发环境，这条命令要在每个开发者机器上单独执行
• 某些老旧 CI 系统（比如 Jenkins 插件未更新）可能仍硬编码 master，得同步改配置

最容易被忽略的是远程平台上的默认分支设置——光改本地和推送新分支没用，GitHub/GitLab 的 UI 里那一步必须手动点选，否则 git clone 出来还是 master。