Skip to content

多電腦管理程式碼

如果你在多台電腦上使用 Git 來管理 GitHub 上的程式碼,以下是一個標準的作業流程,以確保版本一致且避免衝突。


多台電腦使用 Git 管理 GitHub 上的程式碼:標準作業流程

1. 在新電腦上第一次設定(僅需一次)

  1. 安裝 Git(如果尚未安裝):

    • Windows: Git for Windows
    • macOS: brew install git
    • Linux: sudo apt install git(Ubuntu)或 sudo yum install git(CentOS)
  2. 設定 Git 使用者資訊(確保 Git 記錄正確的提交者):

    git config --global user.name "你的 GitHub 使用者名稱"
    git config --global user.email "你的 GitHub 註冊郵件"
    
  3. 確保你的 SSH 金鑰已加入 GitHub(如果使用 SSH 方式):

    • 產生 SSH 金鑰(如果沒有):

      ssh-keygen -t rsa -b 4096 -C "你的 GitHub 註冊郵件"
      
    • 複製 ~/.ssh/id_rsa.pub 內容,並加入 GitHub SSH Key 設定

  4. 從 GitHub 克隆專案到新電腦

    git clone git@github.com:你的使用者名稱/你的專案.git
    

    或使用 HTTPS:

    git clone https://github.com/你的使用者名稱/你的專案.git
    

2. 日常使用流程(多台電腦同步)

當你要在不同電腦上編輯 GitHub 上的程式碼時,請依照以下步驟確保版本同步:

(A)開始前,確保你的程式碼是最新的

  1. 切換到主分支(或你的開發分支)

    git checkout main  # 或其他開發中的分支
    
  2. 拉取最新的變更

    git pull origin main  # 確保你有最新版本
    

    如果有多個開發分支,請改成:

    git pull origin 你的分支名稱
    

(B)開發與提交

  1. 開始編輯程式碼

    你可以開始編寫或修改程式碼。

  2. 檢查變更狀態

    git status
    
  3. 加入變更到 Git 暫存區

    • 新增所有變更:

      git add .
      
    • 或只新增特定檔案:

      git add 檔案名稱
      
  4. 提交變更

    git commit -m "描述你的修改"
    

(C)推送變更到 GitHub

  1. 將提交推送到 GitHub

    git push origin main  # 或你的開發分支
    

(D)在另一台電腦上繼續開發

當你切換到另一台電腦時,請遵循以下步驟確保程式碼與 GitHub 上的一致:

  1. 打開終端機並進入專案目錄

    cd 你的專案資料夾
    
  2. 拉取最新版本

    git pull origin main  # 確保同步最新版本
    
  3. 開始開發並重複上面的提交與推送步驟(B)和(C)


3. 處理可能遇到的問題

(1)如果有合併衝突

當你 git pull 時,若有衝突,Git 會顯示類似:

CONFLICT (content): Merge conflict in 檔案名稱

解法:

  1. 手動編輯衝突的檔案(Git 會標記衝突部分,例如 <<<<<<<
  2. 解決衝突後,標記為已解決

    git add 檔案名稱
    
  3. 提交合併結果

    git commit -m "解決合併衝突"
    
  4. 推送至 GitHub

    git push origin main
    

(2)如果不小心忘記 git pull 就修改了程式碼

這可能導致推送時出現錯誤:

error: failed to push some refs

解法:

  1. 先暫存你的變更

    git stash
    
  2. 拉取最新變更

    git pull origin main
    
  3. 還原你的變更

    git stash pop
    
  4. 再提交並推送

    git add .
    git commit -m "修正後提交"
    git push origin main
    

4. 推薦的最佳實踐

每次開始前先執行 git pull,確保本地版本是最新的。
不要直接修改 main 分支,可先建立分支開發,例如:

```bash
git checkout -b feature-新功能名稱
```

開發完成後合併回 `main`。

使用 .gitignore 避免提交不必要的檔案(如 log、環境變數、編譯檔等)。
使用 GitHub 的 Pull Request 進行多人協作,避免直接推送至 main
定期檢查 git status 以確保檔案狀態清楚


總結

你在不同電腦上的標準 Git 作業流程:

  1. 新電腦時: 安裝 Git、設定 SSH、Clone 專案
  2. 開始開發前: git pull
  3. 開發與提交: git addgit commitgit push
  4. 切換設備時: git pull 確保同步
  5. 遇到衝突時: 手動解決後 git addgit commitgit push

這樣可以確保多台電腦上的 GitHub 專案始終保持同步,避免版本衝突!