Git - 貢獻專案

貢獻基於 Git 的專案涉及協同處理程式碼庫，該程式碼庫通常託管在 GitHub、GitLab 或 Bitbucket 等平臺上。它使多個開發人員能夠同時處理專案，管理更改並簡化合並新功能或修復錯誤的過程。以下是如何開始為 Git 專案做出貢獻：

• Fork 倉庫。

• 克隆 Fork 的倉庫。

• 設定上游遠端倉庫。

• 建立一個新分支。

• 進行更改並提交。

• 將更改推送到你的 Fork。

• 建立一個拉取請求 (PR)。

• 回覆反饋。

• 與上游更改同步。

讓我們在以下章節中詳細研究這些內容。

Fork 倉庫

• Fork 會在你的帳戶下建立一個倉庫的個人副本。這允許你自由地更改程式碼庫，而不會影響原始專案。

• 此步驟通常透過單擊專案倉庫頁面上的“Fork”按鈕來執行。

克隆 Fork 的倉庫

• Fork 倉庫後，你需要將其克隆到你的本地機器。

• 使用以下命令：

  git clone <forked-repository-url>
  

• 這會將程式碼庫的副本下載到你的本地開發環境，你可以在其中開始進行更改。

設定上游遠端倉庫

• 設定上游遠端倉庫會將你的本地倉庫連線到原始倉庫，這使你可以使用主專案中的最新更改來保持你的 Fork 更新。

• 使用以下命令：

  git remote add upstream <original-repository-url>
  

建立一個新分支

• 最佳實踐是為每個你處理的功能或錯誤修復建立一個新分支，而不是直接在 **main** 或 **master** 分支上進行更改。

• 要建立一個新分支：

  git checkout -b feature-branch-name
  

• 使用描述性的分支名稱（例如 **bugfix-issue123** 或 **feature-new-ui-component**）可以更容易地理解分支的目的。

進行更改並提交

• 根據需要編輯程式碼並新增新功能或修復錯誤。

• 進行更改後，使用以下命令將其暫存以進行提交：

  git add . 
  

• 使用描述性訊息提交更改：

  git commit -m "Add feature to enhance UI component"
  

將更改推送到你的 Fork。

• 提交更改後，將其推送到 GitHub 上的 Fork 倉庫（或你使用的平臺）。

• 使用以下命令：

  git push origin feature-branch-name
  

建立一個拉取請求 (PR)。

• 將更改推送到 Fork 的倉庫後，為原始專案建立一個拉取請求。

• 導航到主倉庫，你通常會看到一個選項，可以從你的 Fork 分支建立一個拉取請求。

• 在拉取請求說明中，解釋你所做的更改、其目的以及任何相關的 issue 編號或上下文。

回覆反饋。

• 專案維護者可能會審查你的拉取請求並提供反饋。

• 進行任何請求的更改，將它們提交到同一個分支，然後再次推送。拉取請求將自動更新。

與上游更改同步。

• 為避免合併衝突，請使你的分支與原始倉庫中的最新更改保持同步。

• 獲取最新更改

  git fetch upstream
  

• 將它們合併到你的分支中

  git checkout feature-branch-name
  git merge upstream/main
    

• 如有必要，解決任何衝突。

為 Git 專案做貢獻的最佳實踐

• **閱讀貢獻指南：**大多數專案都有指南，概述了編碼標準、提交訊息格式和分支命名約定。

• **編寫清晰的提交訊息：**使用描述性和簡潔的提交訊息，使其他人更容易理解更改的目的。

• **測試你的更改：**在提交拉取請求之前始終徹底測試你的程式碼，以避免引入錯誤。

• **保持組織：**在處理多個貢獻時，為每個更改使用不同的分支，以使你的工作易於管理。