問題背景
我在使用 Git 進行開發時，由于原有的主分支遭到了污染，不得已在多方嘗試之后，決定替換原有的主分支。創建一個新分支并完成了重要修改：
- 基于提交
0fcb6df0f5e8caa3d853bb1f43f23cfe6d269b18創建了new-development分支 - 在該分支上提交了重要的修改內容（提交ID
b82fd7b9c9c85bd4e063eb096a9d7b92e9a79b76） - 需要將
new-development分支設為主分支，并將原master分支作為存檔分支
在操作過程中，筆者遇到了遠程倉庫配置問題：本地倉庫沒有配置 origin 遠程，而是配置了多個其他別名的遠程倉庫，特別是中文別名的 我的測試項目二期 遠程倉庫。
完整解決方案
第一步：確認當前倉庫狀態
首先查看本地分支情況：
git branch -v
輸出應包含：
master [原主分支]
* new-development b82fd7b9 [您的新提交]old-master [已重命名的舊分支]
第二步：重命名分支（本地操作）
- 重命名原主分支為存檔分支：
git branch -m master old-master
- 切換到新開發分支：
git checkout new-development
- 將此分支設為主分支：
git branch -m master
第三步：解決遠程倉庫配置問題
通過命令分析遠程配置：
git remote -v
輸出顯示存在多個遠程別名：
old-origin https://github.com/Alex-zry-2333/DiMian.git
zrygit https://github.com/Alex-zry-2333/DiMian.git
我的測試項目二期 http://10.10.1.60/Alex_zry_2333/DiMianErQi.git
由于您指定要將更改推送到 我的測試項目二期，我們將以此為目標：
第四步：推送到目標遠程倉庫
- 強制推送新主分支：
# 注意使用引號包裹包含空格的遠程名稱
git push -f "我的測試項目二期" master
- 推送存檔分支：
git push "我的測試項目二期" old-master
第五步：清理其他遠程引用（可選）
- 刪除其他倉庫的原主分支：
# 清理GitHub遠程
git push old-origin --delete master
git push zrygit --delete master
- 清理無效遠程別名：
git remote remove old-origin
git remote remove zrygit
第六步：驗證配置
- 確認最終遠程配置：
git remote -v
輸出應為：
我的測試項目二期 http://10.10.1.60/Alex_zry_2333/DiMianErQi.git (fetch)
我的測試項目二期 http://10.10.1.60/Alex_zry_2333/DiMianErQi.git (push)
- 檢查遠程分支狀態：
git ls-remote "我的測試項目二期"
應顯示：
[b82fd7b9c...] refs/heads/master # 您的新主分支
[原提交哈希] refs/heads/old-master # 存檔分支
最佳實踐：創建簡化別名
為避免中文和空格帶來的操作不便，推薦創建英文別名：
# 添加簡化別名
git remote add dimian http://10.10.1.60/Alex_zry_2333/DiMianErQi.git# 后續操作使用簡化的別名
git push -f dimian master
git push dimian old-master
團隊協作處理指南
如果多人使用此倉庫，請通知團隊成員執行：
# 第一步：更新遠程引用
git fetch --all --prune# 第二步：重置本地主分支
git checkout master
git reset --hard dimian/master # 或對應遠程名# 第三步：清理舊分支
git branch -d old-master # 刪除本地舊分支
技術總結
-
?分支重命名原理?：
git branch -m只是修改分支指針名稱- 不會改變歷史提交
- 保留完整的提交樹結構
-
?強制推送注意事項?：
graph LR A[本地master] -- 強制推送 --> B[遠程master] C[團隊副本] -- 需要重置 --> B- 僅在完全控制分支時使用
-f - 提前協調團隊更新本地副本
- 僅在完全控制分支時使用
-
?遠程倉庫配置方案?：
方案 適用場景 操作示例 標準origin 單倉庫項目 git push origin master多別名配置 多倉庫同步 git push 別名A; git push 別名B自定義別名 復雜命名 git remote add 簡寫名 URL
后續維護建議
-
?分支保護策略?：
- 在倉庫設置中保護
master分支 - 要求 Pull Request 審核才能合并
- 禁止直接推送主分支
- 在倉庫設置中保護
-
?定期清理機制?：
# 每月清理過期分支 git branch -r | grep -Ev 'master|main' | xargs -I {} git push origin --delete {}# 歸檔一年前的舊分支 git tag archive/branches/old-master-2025 old-master git push origin --tags -
?分支命名規范建議?：
master/main: 主分支dev: 開發集成分支feature/*: 功能分支hotfix/*: 緊急修復分支archive/*: 已歸檔分支
https://github.com/0voice
：端口無權限)
 這樣的 Controller 方法)
