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 上了！