How to create a merge request · Gitlab 中文文檔

# How to create a merge request > 原文：[https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html) * [New Merge Request page](#new-merge-request-page) * [Create Merge Request button](#create-merge-request-button) * [New merge request by adding, editing, and uploading a file](#new-merge-request-by-adding-editing-and-uploading-a-file) * [New merge request from a new branch created through the UI](#new-merge-request-from-a-new-branch-created-through-the-ui) * [New merge request from your local environment](#new-merge-request-from-your-local-environment) * [New merge request from an issue](#new-merge-request-from-an-issue) * [New merge request from the Merge Requests page](#new-merge-request-from-the-merge-requests-page) * [New merge request from a fork](#new-merge-request-from-a-fork) * [New merge request by email](#new-merge-request-by-email-core-only) * [Adding patches when creating a merge request via e-mail](#adding-patches-when-creating-a-merge-request-via-e-mail) * [Reviewing and managing Merge Requests](#reviewing-and-managing-merge-requests) # How to create a merge request[](#how-to-create-a-merge-request "Permalink") 在創建合并請求之前，請通讀"合并請求"的[簡介，](getting_started.html)以熟悉概念，術語并了解如何使用它們. 每個合并請求都從創建一個分支開始. 您可以通過[命令行](#new-merge-request-from-your-local-environment) ，Git CLI 應用程序或[GitLab UI](#new-merge-request-from-a-new-branch-created-through-the-ui)在本地進行操作. 本文檔介紹了創建合并請求的幾種方法. 啟動新的合并請求時，無論使用哪種方法，都將轉到" [**新合并請求"**頁面，](#new-merge-request-page)以在其中添加有關合并請求的信息. 如果將新分支推送到 GitLab，也不管使用哪種方法，都可以單擊[**Create Merge Request**](#create-merge-request-button)按鈕并從此處啟動合并請求. ## New Merge Request page[](#new-merge-request-page "Permalink") 在" **新合并請求"**頁面上，首先填寫**合并請求**的標題和描述. 如果分支上已經有提交，則標題將用第一條提交消息的第一行預填充，描述將用提交消息中的任何其他行預填充. 在所有情況下，標題都是唯一的必填字段. 在此處，您可以在其中填充信息（標題，描述，受讓人，里程碑，標簽，批準人），然后點擊**創建合并請求** . 在初始屏幕上，您還可以查看提交合并請求之前推送到分支的所有提交，管道和文件更改. [![New Merge Request page](https://img.kancloud.cn/9a/e9/9ae98030285aae1086f5c661b626d507_2086x1824.png)](img/new_merge_request_page_v12_6.png) **提示：**您可以在創建合并請求之前將一次或多次推送到 GitLab 中的分支. ## Create Merge Request button[](#create-merge-request-button "Permalink") 將新分支推送到 GitLab 后，請訪問 GitLab 中的存儲庫，并在屏幕頂??部看到一個號召性用語，您可以從中單擊**創建合并請求**按鈕. [![Create Merge Request button](https://img.kancloud.cn/85/04/85047539d59f81497d0d00b4d5e9695f_1940x140.png)](img/create_merge_request_button_v12_6.png) 您還可以在以下頁面的右上方看到" **創建合并請求"**按鈕： * **Project** page. * **資料庫>文件** page. * **合并請求** page. In this case, GitLab will use the most recent branch you pushed changes to as the source branch, and the default branch in the current project as the target. ## New merge request by adding, editing, and uploading a file[](#new-merge-request-by-adding-editing-and-uploading-a-file "Permalink") 當您選擇通過 GitLab UI 編輯，添加或上傳文件時，在文件末尾，您會看到以下選項：添加**Commit 消息** ，選擇該**提交**的**Target 分支** ，然后選中**Start new**復選框. **具有這些更改的合并請求** . 同樣，如果通過 Web IDE 更改文件，則在左側邊欄中導航到" **提交"**時，將看到這些相同的選項. 添加，編輯或上傳文件后，請執行以下操作： 1. 在提交消息中描述您的更改. 2. 選擇一個現有分支以將您的提交添加到其中，或者，如果您想創建一個新分支，請鍵入新的分支名稱（不帶空格，大寫字母或特殊字符）. 3. 保持選中復選框以立即開始新的合并請求，或者取消選中該復選框以在開始合并請求之前向該分支添加更多更改. 4. Click **提交變更**. 如果您選擇開始合并請求，則將轉到" [**新合并請求"**頁面](#new-merge-request-page) ，您可以在其中填寫信息并提交合并請求. 合并請求將針對存儲庫的默認分支. 如果要更改它，可以稍后通過編輯合并請求來進行更改. ## New merge request from a new branch created through the UI[](#new-merge-request-from-a-new-branch-created-through-the-ui "Permalink") 要通過 GitLab UI 快速開始處理文件，請導航至項目的" **存儲庫">"分支"** ，然后單擊" **新建分支"** . 將創建一個新分支，您可以開始編輯文件. 提交并推送后，您可以單擊" [**創建合并請求"**](#create-merge-request-button)按鈕以打開" [**新合并請求"**頁面](#new-merge-request-page) . 將使用當前分支作為源，并使用當前項目中的默認分支作為目標來啟動新的合并請求. ## New merge request from your local environment[](#new-merge-request-from-your-local-environment "Permalink") 假設您已將存儲庫克隆到計算機中，并且想要開始處理文件更改，請先創建并簽出一個新分支： ``` git checkout -b my-new-branch ``` 處理文件更改，暫存并提交它們： ``` git add . git commit -m "My commit message" ``` 完成后， [將分支推送到 GitLab](../../../gitlab-basics/start-using-git.html#send-changes-to-gitlabcom) ： ``` git push origin my-new-branch ``` 在輸出中，GitLab 將提示您一個直接鏈接來創建合并請求： ``` ... remote: To create a merge request for docs-new-merge-request, visit: remote: https://gitlab-instance.com/my-group/my-project/merge_requests/new?merge_request%5Bsource_branch%5D=my-new-branch ``` 復制該鏈接并將其粘貼到瀏覽器中，將顯示" [**新合并請求"頁面**](#new-merge-request-page) . 在[通過命令行推送時](../push_options.html) ， [還可以向命令添加](../push_options.html)一些[標志，](../push_options.html)以減少通過 UI 手動編輯合并請求的需要. 如果您沒有通過命令行將分支推送到 GitLab（例如，您使用 Git CLI 應用程序來推送更改），則可以通過單擊" [**創建合并請求"**](#create-merge-request-button)按鈕通過 GitLab UI [**創建合并請求**](#create-merge-request-button) . ## New merge request from an issue[](#new-merge-request-from-an-issue "Permalink") 您也可以[直接從 issue 創建一個新的合并請求](../repository/web_editor.html#create-a-new-branch-from-an-issue) . ## New merge request from the Merge Requests page[](#new-merge-request-from-the-merge-requests-page "Permalink") 您可以通過在項目中的" **合并請求"**頁面上單擊" **新建合并請求"**按鈕來開始創建新的合并請求. 然后選擇包含更改的源項目和分支，以及要將更改合并到的目標項目和分支. 單擊**比較分支，然后繼續**轉到" [**新合并請求"**頁面](#new-merge-request-page)并填寫詳細信息. ## New merge request from a fork[](#new-merge-request-from-a-fork "Permalink") 分叉項目并應用本地更改后，請完成以下步驟，從您的 fork 創建一個合并請求以貢獻回主項目： 1. 轉到**項目>您的項目，**然后選擇存儲庫的分支. 2. 在左側菜單中，轉到**合并請求** ，然后點擊**新建合并請求** . 3. 在" **源分支"**下拉列表框中，在分支的存儲庫中選擇您的分支作為源分支. 4. 在" **目標分支"**下拉列表框中，從上游存儲庫中選擇分支作為目標分支. 5. 輸入憑據后，單擊" **比較分支"，然后繼續**將本地更改與上游存儲庫進行比較. 6. 分配用戶以查看您的更改，然后點擊**提交合并請求** . 合并更改后，您的更改將按照規范添加到上游存儲庫和分支中. 合并工作后，如果您不想對上游項目做出任何其他貢獻，則可以通過[刪除分支關系](../settings/index.html#removing-a-fork-relationship) ，在**Settings> Advanced Settings**部分[中將 fork 與](../settings/index.html#removing-a-fork-relationship)上游項目斷開鏈接. 有關更多詳細信息， [請參閱分叉工作流文檔](../repository/forking_workflow.html) . ## New merge request by email[](#new-merge-request-by-email-core-only "Permalink") *要使用此功能，需要由 GitLab 管理員配置[傳入電子郵件](../../../administration/incoming_email.html)才能使用.* 它在 GitLab.com 中不可用. 您可以通過將電子郵件發送到特定于用戶的電子郵件地址來創建新的合并請求. 通過單擊**將新的合并請求**通過**電子郵件發送到該項目**按鈕，可以在合并請求頁面上獲取地址. 該主題將用作新合并請求的源分支名稱，而目標分支將是項目的默認分支. 消息正文（如果不為空）將用作合并請求描述. 您需要啟用["通過電子郵件回復"](../../../administration/reply_by_email.html)才能使用此功能. 如果您的實例未啟用它，則可以要求您的 GitLab 管理員這樣做. 這是一個私人電子郵件地址，僅為您生成. **將其保存在自己**手中，因為擁有它的任何人都可以像您一樣創建問題或合并請求. 您可以將此地址添加到您的聯系人列表中以便于訪問. [![Create new merge requests by email](https://img.kancloud.cn/0f/c4/0fc4f8b2bf891993c818cd279c89e964_2348x818.png)](img/create_from_email.png) *在 GitLab 11.7 中，我們更新了生成的電子郵件地址的格式. 但是，仍支持較舊的格式，從而允許現有別名或聯系人繼續工作.* ### Adding patches when creating a merge request via e-mail[](#adding-patches-when-creating-a-merge-request-via-e-mail "Permalink") 在 GitLab 11.5 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/22723) . 您可以通過將補丁添加為電子郵件的附件，將提交添加到正在創建的合并請求中. 文件名以`.patch`結尾的所有附件都將被視為補丁程序，并將按名稱順序對其進行處理. 補丁的總大小可以是 2MB. 如果主題的源分支不存在，那么將從存儲庫的 HEAD 或指定的目標分支創建源分支以應用補丁. 可以使用[`/target_branch`快速操作](../quick_actions.html)指定目標分支. 如果源分支已經存在，則將在其頂部應用補丁. ## Reviewing and managing Merge Requests[](#reviewing-and-managing-merge-requests "Permalink") 提交合并請求后，可以通過 GitLab 進行[審查和管理](reviewing_and_managing_merge_requests.html) .