引言

Git作為現代軟件開發中不可或缺的版本控制工具，掌握其核心命令是每個開發者的必修課。本文將通過一個完整的項目流程，詳細講解如何在GitHub上使用Git進行分支管理、版本發布和代碼合并。無論你是剛接觸Git的新手，還是希望梳理操作流程的開發者，本文都將為你提供清晰的實踐指南。

---

一、初始化項目與基礎配置

1.1 克隆遠程倉庫

git clone https://github.com/your-username/your-repo.git
cd your-repo

替換your-username和your-repo為實際的GitHub賬號和倉庫名

1.2 查看當前分支狀態

git status

該命令會顯示當前所在分支（默認為main）及工作目錄狀態

---

二、創建與管理分支

2.1 從main分支創建新功能分支

git checkout -b feature/new-feature

或使用新版本Git的簡化命令：

git switch -c feature/new-feature

feature/new-feature為自定義的分支名稱，建議遵循feature/xxx命名規范

2.2 查看分支列表

git branch -a

-a參數會顯示所有本地和遠程分支

2.3 提交代碼到新分支

git add .
git commit -m "Implement new feature"

2.4 推送分支到GitHub

git push -u origin feature/new-feature

-u參數會將本地分支與遠程分支建立追蹤關系

---

三、版本發布與標簽管理

3.1 創建輕量標簽（推薦用于簡單版本標識）

git tag v1.0.0

3.2 創建附注標簽（推薦用于正式發布）

git tag -a v1.0.0 -m "Release version 1.0.0"

-a參數創建帶附注的標簽，-m指定標簽信息

3.3 推送標簽到遠程倉庫

git push origin v1.0.0

若需推送所有標簽：

git push --tags

3.4 查看標簽信息

git show v1.0.0

---

四、代碼合并與沖突解決

4.1 切換回main分支

git checkout main

4.2 拉取最新代碼（避免合并沖突）

git pull origin main

4.3 合并功能分支到main

git merge feature/new-feature

沖突解決流程：

1. Git會提示沖突文件
2. 手動編輯沖突文件，保留需要的代碼
3. 標記沖突已解決：

   git add <conflicted-file>
   

4. 完成合并：

   git commit
   

4.4 刪除已合并的分支（可選）

git branch -d feature/new-feature

強制刪除未合并的分支：

git branch -D feature/new-feature

---

五、GitHub操作補充

5.1 創建Pull Request（PR）

1. 登錄GitHub倉庫
2. 在Compare & pull request頁面創建PR
3. 填寫描述并提交
4. 等待代碼審查后合并

5.2 查看標簽詳情

在GitHub倉庫的Releases頁面可查看所有tag信息

---

六、最佳實踐建議

1. 分支策略：采用main（生產環境）和develop（開發環境）雙分支模式
2. 標簽規范：遵循語義化版本號（如v1.2.3）
3. 合并前檢查：確保功能分支已通過CI/CD測試
4. 定期同步：定期從main拉取最新代碼避免大沖突

---

結語

通過本文的實踐流程，你已經掌握了Git的核心操作：分支創建、代碼開發、版本發布和合并管理。建議在實際項目中多加練習，同時結合GitHub的圖形化界面進行輔助操作。記住，良好的版本控制習慣能顯著提升團隊協作效率，讓代碼迭代更加安全可控。

提示：可通過git help或git <command> --help查看具體命令的詳細文檔