Git 初次推送远程仓库（完整实战版）

—— 涵盖重命名分支、强制合并、冲突解决等高频场景

---

🔥 核心流程图

初始化 → 关联远程 → 提交代码 → 处理分支冲突 → 成功推送

---

1. 基础操作（全新仓库）

# 初始化
cd /your/project
git init# 关联远程（SSH方式）
git remote add origin git@github.com:用户名/仓库名.git# 提交代码
git add .
git commit -m "初始提交"

---

2. 分支管理（解决名称冲突）

▶ 场景1：本地默认是 master，远程需要 main

# 重命名本地分支
git branch -m master main# 首次推送（建立追踪关系）
git push -u origin main

▶ 场景2：远程已有内容，需要强制合并

# 拉取远程并允许无关历史（关键！）
git pull origin main --allow-unrelated-histories# 解决冲突后提交
git add .
git commit -m "合并远程初始内容"

---

3. 强制覆盖远程（慎用！）

# 强制用本地覆盖远程（适合全新项目）
git push origin main --force
# 或指定分支映射
git push origin main:main --force

---

4. 高频问题速查表

问题	命令
远程已存在	git remote set-url origin 新地址
提交历史冲突	git pull --allow-unrelated-histories
分支名不匹配	git branch -m 旧分支名 新分支名
权限被拒绝	git remote -v 检查协议（SSH/HTTPS）

---

✅ 验证成功

git log --oneline --graph  # 检查提交树
git remote show origin    # 查看远程关联

---

💡 一句话总结

「先改名，再拉取，冲突合并要允许，强制推送需谨慎」
适用于：全新项目首次推送、旧仓库迁移、分支重构等场景。

🚀 现在你的代码已经稳稳站在 GitHub 上了！