使用 Git 和 GitHub 將遠端分支代碼引入本地開發分支：新手指南

更新日期： 2024 年 12 月 13 日

在版本控制系統 Git 中，一個常見的需求是：在本地開發分支進行開發時，需要引入遠端另一個分支的最新代碼。

這篇文章將詳細說明如何在保持當前分支進度的情況下，引入遠端代碼的正確流程，並提供分步指導與最佳實踐，幫助新手快速掌握這項操作。

大流程概述

這個操作的主要步驟包括：

1. 確認當前分支並切換到目標分支。
2. 提交或暫存當前未完成的代碼。
3. 拉取遠端分支的最新內容。
4. 合併遠端分支到本地開發分支。
5. 恢復暫存的代碼（如果需要）。

每個步驟中，我們都需要關注 HEAD 的指向，確保當前的工作環境一致。

操作詳解

確認當前分支

操作
首先，檢查您是否處於目標開發分支（如 issues/19）：

git status

使用以下命令查看當前分支：

git branch

當前分支前會標記 *，例如：

* issues/19

如果您不在目標分支，請切換：

git switch issues/19

提交當前進度

操作
如果有未提交的代碼更改，應該先將它們提交到本地存儲庫：

git add .
git commit -m "暫存目前的進度"

此時，HEAD 將指向最新的提交。

（可選）暫存未提交的變更

操作
如果您不想提交代碼，也可以將當前變更暫存起來，避免影響後續操作：

git stash

效果
暫存後，工作目錄會被清空，未提交的變更存入暫存區（stash）。這樣，HEAD 仍然指向當前分支的最新提交。

拉取遠端的最新內容

操作
確保本地同步了遠端的最新內容：

git fetch

這一操作只會更新本地存儲的遠端分支快照（如 origin/issues/14），不會改變 HEAD 的指向。

合併遠端分支內容

操作
將遠端分支（如 origin/issues/14）的代碼合併到當前開發分支：

git merge origin/issues/14

處理衝突
如果合併過程中出現衝突，按以下步驟解決：

1. 解決衝突的文件。
2. 添加已解決的文件： git add <resolved_files>
3. 提交合併結果： git commit

恢復暫存的變更（如果執行過 git stash）

操作
如果在操作前使用過 git stash，可以在完成合併後恢復暫存的變更：

git stash pop

處理衝突
恢復過程中可能會出現衝突，處理步驟與上文相同。

關於 HEAD 的指向

1. 什麼是 HEAD？
   HEAD 是 Git 中的一個指針，表示您當前檢查出的分支或提交。
2. 如何確認 HEAD 指向？
   使用 git branch 查看： * issues/19 表示 HEAD 正指向 issues/19。
3. 最佳實踐
   • 在開發過程中，HEAD 應始終指向當前的開發分支。
   • 在操作遠端分支時，保持 HEAD 不變，確保工作環境穩定。

指令總結

以下是完整的指令流程：

# 1. 確認當前分支
git status
git branch
git switch issues/19

# 2. 提交當前進度（如有未提交變更）
git add .
git commit -m "暫存目前的進度"

# 3. 或者暫存未提交的變更
git stash

# 4. 拉取遠端最新內容
git fetch

# 5. 合併遠端分支內容到當前分支
git merge origin/issues/14
# 解決衝突後：
git add <resolved_files>
git commit

# 6. 恢復暫存的變更（如果有執行 stash）
git stash pop

最佳實踐

1. 隨時檢查分支狀態
   在進行任何操作前，使用 git status 確認分支和代碼狀態。
2. 保持工作環境整潔
   提交或暫存未完成的變更，避免影響後續操作。
3. 處理衝突時保持冷靜
   仔細解決衝突後再提交，確保代碼邏輯正確。

希望這篇指南能幫助您順利完成遠端分支代碼的引入操作！🎉