在 Git 版本管理中，如果你希望从零开始初始化一个项目并强制使用 master 作为主分支（而非默认的 main），可以按照以下标准流程操作。适用于 Gitee、GitHub 等平台。

💡 背景说明：自 2021 年起，主流 Git 平台（如 GitHub、Gitee）新建仓库默认分支已从 master 改为 main。但许多开发者或团队仍习惯使用 master，本文提供完整解决方案。

---

✅ 操作步骤

步骤1：初始化本地 Git 仓库

在项目根目录执行：

git init

此命令会创建 .git 目录，初始化本地版本库。

---

步骤2：创建并切换到 master 分支

Git 初始化后默认分支可能是 main（取决于 Git 版本），我们主动创建 master 分支并切换过去：

git checkout -b master

• -b 表示创建新分支
• 执行后当前分支即为 master

---

步骤3：添加文件到暂存区

将项目所有文件加入 Git 跟踪：

git add .

• . 表示当前目录下所有文件
• 若只需添加部分文件，可指定路径：git add src/

---

步骤4：提交代码到本地仓库

提交暂存区内容，并附上初始提交信息：

git commit -m "Initial commit"

提交信息建议简洁明确，如 "初始化项目"。

---

步骤5：关联远程仓库

将本地仓库与远程空仓库绑定（请替换为你的实际地址）：

git remote add origin https://gitee.com/用户名/仓库名.git

🔔 注意：

• origin 是远程仓库的默认别名
• URL 中的 用户名 必须是你 Gitee 的真实账号名（如 yangwenkang）
• 仓库需提前在 Gitee 网页端创建好（且为空）

---

步骤6：推送到远程 master 分支

将本地 master 分支推送到远程，并建立追踪关系：

git push -u origin master

• -u 参数会设置 upstream，后续只需 git push 即可推送
• 首次推送时会弹出认证窗口，需输入：
  • 用户名：Gitee 账号名（如 yangwenkang）
  • 密码：个人访问令牌（Personal Access Token）（不是登录密码！）

---

🧪 完整命令序列（一键复制）

# 1. 初始化本地仓库
git init

# 2. 创建并切换到 master 分支
git checkout -b master

# 3. 添加所有文件
git add .

# 4. 提交代码
git commit -m "Initial commit"

# 5. 关联远程仓库（替换为你的 URL）
git remote add origin https://gitee.com/yangwenkang/my-project.git

# 6. 推送到远程 master 分支
git push -u origin master

✅ 执行成功后，你的项目将以 master 为主分支出现在 Gitee 仓库中！

---

⚠️ 重要补充

1. 为什么不用 main？

• main 是现代默认，但 master 仍是广泛接受的命名
• 团队规范、CI/CD 配置、旧脚本可能依赖 master

2. Gitee 默认分支问题

• 即使你推送了 master，Gitee 网页端默认分支可能仍是 main
• 如需彻底改为 master 为默认分支，请手动在 Gitee 后台设置：

  仓库 → 管理 → 基本设置 → 默认分支 → 选择 master → 保存

3. 认证失败？

• 确保使用 访问令牌（Token） 作为密码
• 用户名不要带 @ 或手机号

---

✅ 总结

目标	命令
强制使用 master	git checkout -b master
推送主分支	git push -u origin master
避免认证错误	用户名 + 访问令牌（非密码）