关于搜索讨论
您可以在整个 GitHub 范围内全局搜索讨论,或在特定组织或仓库内搜索讨论。欲了解更多信息,请参阅 关于在 GitHub 上搜索。
提示
- 本文包含指向 GitHub.com 网站上示例搜索的链接,但您也可以在任何 GitHub 平台上使用相同的搜索过滤器。在示例搜索的链接中,请将
github.com替换为您所在 GitHub 平台的主机名。 - 若想查看可添加到任意搜索限定符以进一步优化结果的搜索语法列表,请参阅 了解搜索语法。
- 对多词搜索词使用引号。例如,要搜索标记为 “In progress” 的 issue,您应搜索
label:"in progress"。搜索不区分大小写。
按标题、正文或评论搜索
使用 in 限定符可以将搜索范围限制在标题、正文或评论。您也可以组合多个限定符,以搜索标题、正文或评论的组合。当省略 in 限定符时,GitHub 将同时搜索标题、正文和评论。
| 限定符 | 示例 |
|---|---|
in:title | welcome in:title 匹配标题中包含 “welcome” 的讨论。 |
in:body | onboard in:title,body 匹配标题或正文中包含 “onboard” 的讨论。 |
in:comments | thanks in:comments 匹配评论中包含 “thanks” 的讨论。 |
在用户或组织的仓库内搜索
要在某个用户或组织拥有的所有仓库中搜索讨论,可使用 user 或 org 限定符。要在特定仓库中搜索讨论,可使用 repo 限定符。
| 限定符 | 示例 |
|---|---|
user:USERNAME | user:octocat feedback 匹配 @octocat 所拥有仓库中包含 “feedback” 一词的讨论。 |
org:ORGNAME | org:github 匹配 GitHub 组织拥有的仓库中的讨论。 |
repo:USERNAME/REPOSITORY | repo:nodejs/node created:<2021-01-01 匹配 @nodejs 的 Node.js 运行时项目中创建于 2021 年 1 月之前的讨论。 |
按打开或关闭状态搜索
您可以使用 is 限定符根据讨论是打开还是关闭进行过滤。
| 限定符 | 示例 |
|---|---|
is:open | performance is:open is:discussion 匹配包含 “performance” 且处于打开状态的讨论。 |
is:closed | android is:closed 匹配包含 “android” 且已关闭的讨论。 |
根据讨论是否已回答进行搜索
您可以使用 is 限定符搜索已被标记为已回答的讨论。
| 限定符 | 示例 |
|---|---|
is:answered | performance is:answered is:discussion 匹配包含 “performance” 且已回答的讨论。 |
is:unanswered | android is:unanswered 匹配包含 “android” 且未回答的讨论。 |
根据讨论是否已锁定进行搜索
您可以使用 is 限定符搜索已被锁定的讨论。有关详细信息,请参阅 审议讨论。
| 限定符 | 示例 |
|---|---|
is:locked | "code of conduct" is:locked is:discussion 匹配包含 “code of conduct” 且已锁定的讨论。 |
is:unlocked | code of conduct is:unlocked is:discussion 匹配包含 “code of conduct” 且未锁定的讨论。 |
按仓库可见性过滤
您可以使用 is 限定符按包含讨论的仓库的可见性进行过滤。有关详细信息,请参阅 关于仓库。
| 限定符 | 示例 |
|---|---|
is:public | is:public 匹配公共仓库中的讨论。 |
is:private | is:private tiramisu 匹配您可以访问的私有仓库中包含 “tiramisu” 一词的讨论。 |
按作者搜索
author 限定符用于查找由特定用户创建的讨论。
| 限定符 | 示例 |
|---|---|
author:USERNAME | cool author:octocat 匹配由 @octocat 创建且包含 “cool” 一词的讨论。 |
in:body author:USERNAME | bootstrap in:body author:octocat 匹配由 @octocat 创建且正文中包含 “bootstrap” 一词的讨论。 |
按评论者搜索
commenter 限定符用于查找包含特定用户评论的讨论。
| 限定符 | 示例 |
|---|---|
commenter:USERNAME | github commenter:becca org:github 匹配 GitHub 组织拥有的仓库中包含 “github” 且有 @becca 评论的讨论。 |
按已回答讨论的用户搜索
answered-by 限定符用于查找某位用户的评论被标记为答案的讨论。
| 限定符 | 示例 |
|---|---|
answered-by:USERNAME | cool answered-by:octocat 匹配由 @octocat 回答且包含 “cool” 一词的讨论。 |
按参与讨论的用户搜索
您可以使用 involves 限定符查找与特定用户有关的讨论。此限定符返回由该用户创建、在正文中提及该用户或由该用户发表评论的讨论。involves 实际上是 author、mentions 与 commenter 三个限定符对同一用户的逻辑 OR。
| 限定符 | 示例 |
|---|---|
involves:USERNAME | involves:becca involves:octocat 匹配 @becca 或 @octocat 参与的讨论。 |
in:body involves:USERNAME | NOT free in:body involves:becca 匹配 @becca 参与且正文中不包含 “free” 一词的讨论。 |
按评论数量搜索
您可以结合大于、小于以及范围限定符使用 comments 限定符来按评论数量搜索。更多信息,请参阅 理解搜索语法。
| 限定符 | 示例 |
|---|---|
comments:n | comments:>100 匹配评论数超过 100 条的讨论。 |
comments:n | comments:500..1000 匹配评论数量在 500 到 1,000 之间的讨论。 |
按讨论创建时间或最近更新时间搜索
您可以根据创建时间或最近更新时间来过滤讨论。使用 created 限定符查找创建时间,使用 updated 限定符查找最近更新时间。
这两个限定符都接受日期作为参数。日期格式必须符合 ISO8601 标准,即 YYYY-MM-DD(年-月-日)。您也可以在日期后添加可选的时间信息 THH:MM:SS+00:00,用于按小时、分钟和秒进行搜索。即 T 后跟 HH:MM:SS(时:分:秒),以及 UTC 偏移量(+00:00)。
在按日期搜索时,您可以使用大于、小于和范围限定符来进一步过滤结果。欲了解更多信息,请参阅 理解搜索语法。
| 限定符 | 示例 |
|---|---|
created:YYYY-MM-DD | created:>2020-11-15 匹配在 2020 年 11 月 15 日之后创建的讨论。 |
updated:YYYY-MM-DD | weird in:body updated:>=2020-02-01 匹配正文中包含 “weird” 且在 2020 年 12 月之后更新的讨论。 |
按类别搜索
您可以按特定的讨论类别过滤讨论。
| 限定符 | 示例 |
|---|---|
category:CATEGORYNAME | category:Ideas 匹配名称为 “Ideas” 的讨论类别。 |
按标签搜索
您可以按已应用于讨论的特定标签进行过滤。
| 限定符 | 示例 |
|---|---|
label: "LABEL NAME" | label:"Product Feedback" 匹配标签为 “Product Feedback” 的讨论。 |