Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon CodeCatalyst 中使用提取請求檢閱程式碼
<a name="source-pull-requests"></a>

提取請求是您和其他專案成員可以檢閱、評論和合併不同分支程式碼變更的主要方式。您可以使用提取請求，針對發行軟體的次要變更或修正、主要功能新增或新版本，協同檢閱程式碼變更。如果您使用問題來追蹤專案上的工作，您可以連結特定問題來提取請求，以協助您追蹤提取請求中的程式碼變更正在解決的問題。當您建立、更新、評論、合併或關閉提取請求時，系統會自動傳送電子郵件給提取請求的作者，以及提取請求的任何必要或選用檢閱者。

**提示**  
您可以設定在設定檔中接收電子郵件的提取請求事件。如需詳細資訊，請參閱[從 CodeCatalyst 傳送 Slack 和電子郵件通知](notifications-manage.md)。

提取請求需要來源儲存庫中的兩個分支：包含您要檢閱之程式碼的來源分支，以及您要合併已檢閱程式碼的目的地分支。來源分支包含「之後」遞交，此遞交包含您想要合併到目的地分支的變更。目的地分支包含「之前」遞交，這代表提取請求分支合併到目的地分支之前的程式碼狀態。

**注意**  
當您建立提取請求時，所顯示的差異是來源分支的尖端與目的地分支的尖端之間的差異。建立提取請求後，所顯示的差異會在您選擇的提取請求修訂版與建立提取請求時目的地分支頂端的遞交之間。如需 Git 中差異和合併基礎的詳細資訊，請參閱 Git 文件中的 [git-merge-base](https://git-scm.com/docs/git-merge-base)。

當針對特定來源儲存庫和分支建立提取請求時，您可以建立、檢視、檢閱和關閉它們，作為使用專案的一部分。您不需要檢視來源儲存庫，即可檢視和使用提取請求。提取請求狀態會在您建立時設定為**開啟**。提取請求會保持開啟狀態，直到您在 CodeCatalyst 主控台中將其合併，將狀態變更為**合併**，或將其關閉，將狀態變更為**關閉**。

檢閱程式碼後，您可以透過下列其中一種方式變更提取請求狀態：
+ 在 CodeCatalyst 主控台中合併提取請求。提取請求來源分支中的程式碼會合併到目的地分支。提取請求狀態會變更為**合併**。它無法變更回**開啟**。
+ 在本機合併分支並推送變更，然後在 CodeCatalyst 主控台中關閉提取請求。
+ 使用 CodeCatalyst 主控台關閉提取請求而不合併。這會將狀態變更為**已關閉**，而且不會將來源分支中的程式碼合併到目的地分支。

在您建立提取請求之前：
+ 遞交您要檢閱的程式碼變更，並將其推送至分支 （來源分支）。
+ 為您的專案設定通知，以便其他使用者收到您在建立提取請求時執行的任何工作流程的通知。（此步驟是選用的，但建議使用。)

**Topics**
+ [建立提取請求](pull-requests-create.md)
+ [檢視提取請求](pull-requests-view.md)
+ [管理將提取請求與核准規則合併的要求](source-pull-requests-approval-rules.md)
+ [檢閱提取請求](pull-requests-review.md)
+ [更新提取請求](pull-requests-update.md)
+ [合併提取請求](pull-requests-merge.md)
+ [關閉提取請求](pull-requests-close.md)