GitHub pull request

Pull Request（拉取請求）是一種非常重要的協(xié)作機(jī)制，它是 Git 和 GitHub 等代碼托管平臺中常見的功能。在開源項(xiàng)目中，Pull Request 被廣泛用于參與社區(qū)貢獻(xiàn)，從而促進(jìn)項(xiàng)目的發(fā)展。

一、fork代碼

先登錄自己的github賬戶，找到自己要提pr的項(xiàng)目。這里我們以datawhalechina/grape-book為例：

如果要fork全部分支，記得一定要去掉只選擇主分支的對勾（默認(rèn)是只選擇主分支）

等待幾秒之后，進(jìn)入主頁就可以看到fork后的項(xiàng)目副本到自己的倉庫目錄下了。

二、clone代碼到本地

執(zhí)行 git clone 命令，將此副本 clone 到本地(推薦使用ssh的形式，可以避免輸入用戶名和密碼)。即在本地的某個目錄下，打開命令行，輸入如下代碼

git clone 紅色框的地址

這樣子代表已經(jīng)成功

三、進(jìn)入到克隆的項(xiàng)目目錄下

執(zhí)行 cd 克隆項(xiàng)目地址 命令，進(jìn)入項(xiàng)目目錄下。即在本地的某個目錄下，打開命令行，輸入如下代碼。

像這樣子，代表已經(jīng)成功。

四、列出所有分支

執(zhí)行git branch -a命令,確認(rèn)下是否克隆下所有分支項(xiàng)目

如圖所示，項(xiàng)目四個分支已經(jīng)全部clone到本地

五、創(chuàng)建一個本地分支，并追蹤遠(yuǎn)程項(xiàng)目分支

執(zhí)行git checkout -b v2 origin/v2 命令,即在本地創(chuàng)建一個名為v2的分支，并將其設(shè)置為跟蹤遠(yuǎn)程的v2分支?，F(xiàn)在，你可以在本地進(jìn)行v2分支上的工作。

六、查看當(dāng)前分支

為了確保所有操作不犯錯，我們在修改內(nèi)容前，需要再一次確認(rèn)下當(dāng)前分支，執(zhí)行git branch 命令，即查看當(dāng)前分支

如圖所示，現(xiàn)在是v2分支。

七、與遠(yuǎn)程倉庫建立連接

查看分支之后，我們看看是否與遠(yuǎn)程倉庫建立了連接

可以看到，已經(jīng)建立連接，

• (fetch) 表示該 URL 地址用于獲取遠(yuǎn)程倉庫的代碼（即拉取操作）。
• (push) 表示該 URL 地址用于向遠(yuǎn)程倉庫推送本地倉庫的代碼。

八、與上游倉庫建立連接

接下來還需要與上游建立連接，這里上游指的是一開始fork的那個項(xiàng)目源，即datawhalechina/grape-book

執(zhí)行git remote add upstream 地址，示例

git remote add upstream https://github.com/datawhalechina/grape-book.git

此時，我們再輸入git remote -v，就可以看到本地已經(jīng)和遠(yuǎn)程倉庫以及上游建立了連接。

• origin 它的拉取作用是獲取用戶在 GitHub 上的 grape-book 倉庫的代碼。它的推送作用是將本地修改的代碼推送到 用戶在 GitHub 上的 grape-book 倉庫中。
• upstream 它的拉取作用是獲取來自 上游成員在 GitHub 上的 grape-book 倉庫的代碼。它的推送作用是將本地修改的代碼推送到上游在 GitHub 上的 grape-book 倉庫中。

八、同步最新代碼

這么做的原因是當(dāng)你在開發(fā)時，如果多人協(xié)作開發(fā)同一個項(xiàng)目，那么可能其他人也在修改代碼并提交到倉庫中。如果你 fork 了這個項(xiàng)目的代碼，那么你 fork 的代碼可能已經(jīng)不是最新的了，因此需要及時更新代碼，以保證你的代碼與倉庫中最新的代碼保持同步。

命令行輸入以下代碼：

 git fetch upstream/v2

即，從上游倉庫 upstream 中獲取分支 v2 的最新代碼,并將最新的代碼合并到你當(dāng)前的分支。

九、修改代碼并提交

修改完畢后，提交變更的代碼：

git add.
git commit -m 'update'
git push -u origin v2:v2

即將本地的 v2 分支推送到名為 origin 的遠(yuǎn)程倉庫的 v2 分支上，并通過 -u 參數(shù)建立本地 v2 分支與遠(yuǎn)程 v2 分支之間的追蹤關(guān)系。

十、提交pr

我們回到自己倉庫的項(xiàng)目主頁，可以看到剛才提交的記錄，則表示之前的操作都已成功。接下來，點(diǎn)擊箭頭所指的Pull Requests選項(xiàng)。

點(diǎn)擊箭頭所指的New pull request按鈕

接下來，點(diǎn)擊Creat pull request即可提交成功。

最后，只需耐心等待管理員的審核即可。開源項(xiàng)目的所有pr記錄可以在這里查看，包括你剛才提交的。

如果你的提交被審核通過，則會像下面這個這樣，顯示All checks have passed