Help us learn about your current experience with the documentation. Take the survey.

高级搜索

使用高级搜索在整个 GitLab 实例中精确找到您需要的内容。

借助高级搜索，您可以：

高级搜索适用于项目、议题、合并请求、里程碑、用户、史诗、代码、评论、提交和 Wiki。

使用高级搜索

前提条件：

必须启用高级搜索：
- 对于 GitLab.com 和 GitLab Dedicated，付费订阅默认启用高级搜索。
- 对于 GitLab Self-Managed，管理员必须启用高级搜索。

要使用高级搜索：

您也可以在项目或群组中使用高级搜索。

范围描述了您正在搜索的数据类型。高级搜索支持以下范围：

范围	全局 ¹ ²	群组	项目
代码	Yes	Yes	Yes
评论	Yes	Yes	Yes
提交	Yes	Yes	Yes
史诗	Yes	Yes	No
议题	Yes	Yes	Yes
合并请求	Yes	Yes	Yes
里程碑	Yes	Yes	Yes
项目	Yes	Yes	No
用户	Yes	Yes	Yes
Wiki	Yes	Yes	Yes

脚注:

高级搜索使用 simple_query_string，它支持精确查询和模糊查询。

当您搜索用户时，默认使用 fuzzy 查询。您可以使用 simple_query_string 来优化用户搜索。

查询	描述
`rails -filename:gemfile.lock`	返回所有文件中的 `rails`，但 `gemfile.lock` 文件除外。
`RSpec.describe Resolvers -*builder`	返回不以 `builder` 开头的 `RSpec.describe Resolvers`。
`bug \| (display +banner)`	返回 `bug`，或者同时返回 `display` 和 `banner`。
`helper -extension:yml -extension:js`	返回所有文件中的 `helper`，但扩展名为 `.yml` 或 `.js` 的文件除外。
`helper path:lib/git`	返回所有路径为 `lib/git*` 的文件中的 `helper`（例如 `spec/lib/gitlab`）。

只能搜索小于 1 MB 的文件。有关更多信息，请参阅 issue 195764。对于 GitLab Self-Managed，管理员可以配置 最大索引文件大小 设置。
您只能在项目的默认分支上使用高级搜索。有关更多信息，请参阅 issue 229966。
搜索查询不能包含以下任何字符：
```
. , : ; / ` ' = ? $ & ^ | < > ( ) { } [ ] @
```
有关更多信息，请参阅 issue 325234。
搜索结果只显示文件中的第一个匹配项。有关更多信息，请参阅 issue 668。