Pull Request 教學

簡介

Pull Request（PR）是一種在GitHub上提交代碼更改的方式。通過PR，您可以請求將您的更改合併到主代碼庫中。這是一種協作開發的常見方式。

創建 Pull Request 的步驟

1. Fork 一個倉庫

首先，您需要在GitHub上fork一個倉庫。這會在您的GitHub帳戶下創建一個該倉庫的副本。

2. 克隆 Fork 後的倉庫

接下來，將fork後的倉庫克隆到您的本地機器上：

git clone <forked_repository_url>

3. 創建一個新分支

在本地倉庫中，創建一個新分支來進行您的更改：

git checkout -b <new_branch_name>

4. 進行代碼更改並提交

在新分支上進行您的代碼更改，然後將更改添加到暫存區並提交：

git add <file_name>
git commit -m "commit message"

5. 推送更改到您的 Fork 倉庫

將您的更改推送到GitHub上的fork倉庫：

git push origin <new_branch_name>

6. 創建 Pull Request

在GitHub上打開您的fork倉庫，點擊 “Compare & pull request” 按鈕。填寫PR的標題和描述，然後點擊 “Create pull request” 按鈕。

審查 Pull Request 的步驟

1. 轉到 GitHub 上的 PR

在GitHub上打開您要審查的PR。

2. 審查更改

查看PR中的代碼更改，並在必要時留下評論。

3. 批准或請求更改

如果您認為PR中的更改是正確的，可以批准PR；如果需要進一步修改，可以請求更改。

4. 合併 PR

一旦PR獲得批准，您可以將其合併到主代碼庫中。

撤回提交

如果您需要因為提交錯誤而撤回提交，可以使用以下命令：

git revert <commit_hash>

此命令會創建一個新提交，撤銷指定提交所做的更改。

使用 reset 撤回提交

如果您需要撤回提交並且不保留提交記錄，可以使用以下命令：

git reset --hard <commit_hash>

此命令會將當前分支重置到指定的提交，並且不保留之後的提交記錄。

reset 和 revert 的區別

  • git revert 會創建一個新提交，撤銷指定提交所做的更改，保留提交記錄。
  • git reset 會將當前分支重置到指定的提交，不保留之後的提交記錄。

結論

本教學涵蓋了創建和審查Pull Request的基本步驟。通過遵循這些步驟，您可以有效地使用GitHub來協作開發代碼。