reviewing.md 7.9 KB
Newer Older
Lab机器人's avatar
Lab机器人 已提交
1
# 评审及管理合并请求[](#评审及管理合并请求 "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
2

Lab机器人's avatar
Lab机器人 已提交
3
合并请求是在项目中更改文件的主要方法,通过[创建并提交合并请求](creating_merge_requests.html)来提出更改,然后将其审核并接受(或拒绝)。
Lab机器人's avatar
readme  
Lab机器人 已提交
4

Lab机器人's avatar
Lab机器人 已提交
5
## 评审合并请求[](#view-project-merge-requests "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
6

Lab机器人's avatar
Lab机器人 已提交
7
打开 **项目>合并请求**列表,可以查看项目中的所有**合并请求**,并且您可以快速按打开和关闭可用的选项卡来进行过滤,您还可以[搜索和过滤结果](../../search/index.html#filtering-issue-and-merge-request-lists)
Lab机器人's avatar
readme  
Lab机器人 已提交
8

Lab机器人's avatar
Lab机器人 已提交
9
[![Project merge requests list view](img/project_merge_requests_list_view.png)](img/project_merge_requests_list_view.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
10

Lab机器人's avatar
Lab机器人 已提交
11
## 半线性历史合并请求[](#semi-linear-history-merge-requests "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
12

Lab机器人's avatar
Lab机器人 已提交
13
每个合并创建一个合并提交,但是只有在可能进行快速合并的情况下才合并分支。这样可以确保如果合并请求构建成功,则合并后目标分支构建也将成功。
Lab机器人's avatar
readme  
Lab机器人 已提交
14

Lab机器人's avatar
Lab机器人 已提交
15
进入到项目设置页,在 **合并请求:合并方法**下选择 **使用半线性历史** **合并合并**选项,然后保存更改。
Lab机器人's avatar
readme  
Lab机器人 已提交
16

Lab机器人's avatar
Lab机器人 已提交
17
## 查看不同版本文件变更[](#view-changes-between-file-versions "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
18

Lab机器人's avatar
Lab机器人 已提交
19
**更改**选项卡位于主要合并请求详细信息下方,并且在讨论选项卡旁边,显示了分支或提交之间文件的更改。这种对文件更改的视图也称为**diff** ,默认情况下,差异视图将合并请求分支中的文件与目标分支中的文件进行比较。
Lab机器人's avatar
readme  
Lab机器人 已提交
20

Lab机器人's avatar
Lab机器人 已提交
21
Diff 视图包含以下内容:
Lab机器人's avatar
readme  
Lab机器人 已提交
22

Lab机器人's avatar
Lab机器人 已提交
23 24
*   文件的名称和路径
*   添加和删​​除的行数
Lab机器人's avatar
readme  
Lab机器人 已提交
25
*   用于以下选项的按钮:
Lab机器人's avatar
Lab机器人 已提交
26 27 28 29 30
    *   文件讨论显示/隐藏开关,在查看用于内联评论时非常有用
    *   在合并请求的分支中编辑文件
    *   显示完整文件,方便您要查看上下文中文件其余部分的更改
    *   查看当前提交时的文件
*   对于有更改的行,将突出显示详细的更改内容
Lab机器人's avatar
readme  
Lab机器人 已提交
31

Lab机器人's avatar
Lab机器人 已提交
32
[![Example screenshot of a source code diff](/docs/img/merge_request_diff_v13_2.png)](/docs/img/merge_request_diff_v13_2.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
33

Lab机器人's avatar
Lab机器人 已提交
34
### 合并请求 diff 导航[](#merge-request-diff-file-navigation "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
35

Lab机器人's avatar
Lab机器人 已提交
36
**更改**选项卡中查看更改时,可以使用文件树或文件列表来浏览差异。 在具有许多更改的大型差异中滚动时,可以使用文件树或文件列表快速跳转到任何更改的文件。
Lab机器人's avatar
readme  
Lab机器人 已提交
37

Lab机器人's avatar
Lab机器人 已提交
38
[![Merge request diff file navigation](/docs/img/merge_request_diff_file_navigation.png)](docs/img/merge_request_diff_file_navigation.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
39

Lab机器人's avatar
Lab机器人 已提交
40
### 逐个文件查看 diff[](#file-by-file-diff-navigation "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
41

Lab机器人's avatar
Lab机器人 已提交
42
对于较大的合并请求,有时一次查看单个文件可能会很有用。要启用单个文件 diff 导航时,请从右上角导航栏上的头像,单击**"设置"** ,然后转到左侧边栏上的**"偏好设置"** , 向下滚动到" **个性化"**部分,然后**在合并请求的"更改"标签上**选择**"一次显示一个文件"** . 点击**保存更改**以应用.
Lab机器人's avatar
readme  
Lab机器人 已提交
43 44 45

从那里,在查看合并请求的" **更改"**选项卡时,一次只能看到一个文件. 然后,您可以单击按钮上**一个****下一个**以查看其他已更改的文件.

Lab机器人's avatar
Lab机器人 已提交
46
[![File-by-file diff navigation](/docs/img/file_by_file_v13_2.png)](docs/img/file_by_file_v13_2.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
47

Lab机器人's avatar
Lab机器人 已提交
48
### 合并请求提交导航[](#merge-requests-commit-navigation "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
49

Lab机器人's avatar
Lab机器人 已提交
50
要在合并请求中的**提交**之间无缝导航,请从 **提交**选项卡中,单击其中一个提交以打开单提交视图,之后您可以通过单击页面右上角的**Prev****Next**按钮或使用`X``C`键盘快捷键在提交之间进行切换。
Lab机器人's avatar
readme  
Lab机器人 已提交
51

Lab机器人's avatar
Lab机器人 已提交
52
### 合并请求 diff 时展开[](#incrementally-expand-merge-request-diffs "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
53

Lab机器人's avatar
Lab机器人 已提交
54
默认情况下,差异仅显示文件中已更改的部分。要查看更改上方或下方的更多未更改行,请单击" **向上** **扩展"**或" **向下扩展"**图标,您也可以单击**显示未更改的行**以展开整个文件。
Lab机器人's avatar
readme  
Lab机器人 已提交
55

Lab机器人's avatar
Lab机器人 已提交
56
当查看合并请求的**更改**选项卡时,如果仅重命名了某个文件,则可以通过单击**显示文件内容**展开它以查看全部**内容**
Lab机器人's avatar
readme  
Lab机器人 已提交
57

Lab机器人's avatar
Lab机器人 已提交
58
### 隐藏空白更改[](#ignore-whitespace-changes-in-merge-request-diff-view "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
59

Lab机器人's avatar
Lab机器人 已提交
60
如果单击**隐藏空白更改**按钮,则可以看到没有空白更改的差异(如果有的话),在查看某个提交的页面上也支持这个功能。
Lab机器人's avatar
readme  
Lab机器人 已提交
61

Lab机器人's avatar
Lab机器人 已提交
62
> **提示:**您可以在合并请求的差异页面上附加`?w=1` ,以忽略任何空格更改。
Lab机器人's avatar
readme  
Lab机器人 已提交
63

Lab机器人's avatar
Lab机器人 已提交
64
## 行内代码评审[](#perform-inline-code-reviews "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
65

Lab机器人's avatar
Lab机器人 已提交
66
我们提供了一种在合并请求中更改文件的任何部分中进行注释讨论的方法,可以在"合并请求"差异页面左侧单击**评论**按钮以展开差异行并留下评论,就像更改行一样。
Lab机器人's avatar
readme  
Lab机器人 已提交
67

Lab机器人's avatar
Lab机器人 已提交
68
[![Comment on any diff file line](/docs/img/comment-on-any-diff-line.png)](/docs/img/comment-on-any-diff-line.png)
Lab机器人's avatar
readme  
Lab机器人 已提交
69

Lab机器人's avatar
Lab机器人 已提交
70
## 关联功能[](#associated-features "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
71 72 73

还有大量与合并请求关联的功能:

Lab机器人's avatar
Lab机器人 已提交
74
| 功能 | 描述 |
Lab机器人's avatar
readme  
Lab机器人 已提交
75
| --- | --- |
Lab机器人's avatar
Lab机器人 已提交
76 77 78 79 80 81
| [批量编辑合并请求](../project/bulk_edit.md) | 同时更新多个合并请求的属性 |
| [Cherry-pick 变更](cherry_pick.md) | 只需在合并的合并请求或提交中单击**Cherry-pick**按钮,即可在页面中 Cherry-pick 任何**选择** |
| [快进合并](fast_forward.md) | 有关线性 Git 历史记录以及接受合并请求而不创建合并提交的方法 |
| [合并请求版本](versions.md) | 选择并比较合并请求差异的不同版本 |
| [解决冲突](resolve_conflicts.md) |可以在界面中来解决某些合并请求冲突 |
| [Revert 更改](revert.md) | 从合并请求中的任何提交还原更改 |
Lab机器人's avatar
readme  
Lab机器人 已提交
82 83 84

## Tips[](#tips "Permalink")

Lab机器人's avatar
Lab机器人 已提交
85
以下是一些可帮助您在命令行中更有效地处理合并请求的 Tips:
Lab机器人's avatar
readme  
Lab机器人 已提交
86

Lab机器人's avatar
Lab机器人 已提交
87
### 本地合并合并请求[](#checkout-merge-requests-locally "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
88

Lab机器人's avatar
Lab机器人 已提交
89
合并请求包含来自代码仓库的所有历史记录,以及添加到与合并请求关联的分支的其他提交。以下是一些在本地检出合并请求的技巧。
Lab机器人's avatar
readme  
Lab机器人 已提交
90

Lab机器人's avatar
Lab机器人 已提交
91
请注意,即使源项目是目标项目的分支(甚至是私有分支),也可以在本地签出合并请求。
Lab机器人's avatar
readme  
Lab机器人 已提交
92

Lab机器人's avatar
Lab机器人 已提交
93
#### 通过别名设置签出合并请求[](#checkout-locally-by-adding-a-git-alias "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
94 95 96

将以下别名添加到`~/.gitconfig`

Lab机器人's avatar
Lab机器人 已提交
97
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
98 99 100 101
[alias]
    mr = !sh -c 'git fetch $1 merge-requests/$2/head:mr-$1-$2 && git checkout mr-$1-$2' - 
```

Lab机器人's avatar
Lab机器人 已提交
102
现在,您可以从任何代码仓库和任何远程签出特定的合并请求,例如,执行以下操作可以从`origin`远程服务器签出 ID 为 5 的合并请求请:
Lab机器人's avatar
readme  
Lab机器人 已提交
103

Lab机器人's avatar
Lab机器人 已提交
104
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
105 106 107
git mr origin 5 
```

Lab机器人's avatar
Lab机器人 已提交
108
这会将合并请求提取到本地`mr-origin-5`分支中,并检出它。
Lab机器人's avatar
readme  
Lab机器人 已提交
109

Lab机器人's avatar
Lab机器人 已提交
110
#### 通过在 config 文件中添加代码仓库签出[](#checkout-locally-by-modifying-gitconfig-for-a-given-repository "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
111

Lab机器人's avatar
Lab机器人 已提交
112
`.git/config`文件中找到适用于 remote 的部分,找到类似下面的这段配置:
Lab机器人's avatar
readme  
Lab机器人 已提交
113

Lab机器人's avatar
Lab机器人 已提交
114
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
115
[remote "origin"]
Lab机器人's avatar
Lab机器人 已提交
116
  url = https://codechina.csdn.net/codechina/awsome-project.git
Lab机器人's avatar
readme  
Lab机器人 已提交
117 118 119 120 121
  fetch = +refs/heads/*:refs/remotes/origin/* 
```

您可以使用以下方式打开文件:

Lab机器人's avatar
Lab机器人 已提交
122
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
123 124 125 126 127
git config -e 
```

现在,将以下行添加到上面的部分:

Lab机器人's avatar
Lab机器人 已提交
128
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
129 130 131 132 133
fetch = +refs/merge-requests/*/head:refs/remotes/origin/merge-requests/* 
```

最后,它应如下所示:

Lab机器人's avatar
Lab机器人 已提交
134
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
135
[remote "origin"]
Lab机器人's avatar
Lab机器人 已提交
136
  url = https://codechina.csdn.net/codechina/awsome-project.git
Lab机器人's avatar
readme  
Lab机器人 已提交
137 138 139 140 141 142
  fetch = +refs/heads/*:refs/remotes/origin/*
  fetch = +refs/merge-requests/*/head:refs/remotes/origin/merge-requests/* 
```

现在,您可以获取所有合并请求:

Lab机器人's avatar
Lab机器人 已提交
143
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
144 145 146
git fetch origin

...
Lab机器人's avatar
Lab机器人 已提交
147
From https://codechina.csdn.net/codechina/awsome-project.git
Lab机器人's avatar
readme  
Lab机器人 已提交
148 149 150 151 152 153 154
 * [new ref]         refs/merge-requests/1/head -> origin/merge-requests/1
 * [new ref]         refs/merge-requests/2/head -> origin/merge-requests/2
... 
```

并检查特定的合并请求:

Lab机器人's avatar
Lab机器人 已提交
155
```markdown
Lab机器人's avatar
readme  
Lab机器人 已提交
156 157 158
git checkout origin/merge-requests/1 
```

Lab机器人's avatar
Lab机器人 已提交
159
以上所有操作均可通过[`git-mr`](https://gitlab.com/glensc/git-mr)脚本完成。