Loading...

文章背景图

GitHub 高级搜索语法

2023-11-14
0
- 字
- 分钟
|

原文链接,如需查看,请点击这里

前言

最近逛GitHub总是因为搜不到满意的答案而感觉GitHub很low,但是技术大牛们都说闲暇时间都在逛GitHub来了解当下的火热开源项目和技术啥的,就感觉很困惑,他们是如果精准查到自己需要的资源的呢,于是在网上搜索了一波相关解答,结果真的是我的姿势有问题,如下进行了一番记录总结

普通的搜索

相信一般人搜索项目时,都是和以前的我一样,直接搜索技术栈相关的项目

高级一点的搜索,会根据最匹配、最多 Star 来进行排序、选择相应的语言、选择仓库或者代码来进行筛选

一波了解之后才知道 GitHub 支持的搜索功能远远不止于此,以上的功能仅仅是 GitHub 搜索的冰山一角

GitHub 的搜索是非常强大的!下面介绍更高级的搜索技巧

搜索语法

搜索 GitHub 时,其实可以构建匹配特定数字和单词的查询

查询大于或小于另一个值的值

  • 查询大于或小于另一个值的值
    • 可以使用 >、>=、< 和 <= 搜索大于、大于等于、小于以及小于等于另一个值的值
查询 示例
>n vue stars:>1000 匹配含有 ‘vue’ 字样、星标超过 1000 个的仓库
>=n vue topics:>=5 匹配含有 ‘vue’ 字样、有 5 个或更多主题的仓库
<n vue size:<10000 匹配小于 10 KB 的文件中含有 “vue” 字样的代码
<=n vue stars:<=50 匹配含有 ‘vue’ 字样、星标不超过 50 个的仓库

还可以使用 范围查询 搜索大于等于或小于等于另一个值的值

查询 示例
n.. vue stars:10…* 等同于 stars:>=10 并匹配含有 ‘vue’ 字样、有 10 个或更多星号的仓库
..n vue stars:*…10 等同于 stars:<=10 并匹配含有 ‘vue’ 字样、有不超过 10 个星号的仓库

查询范围之间的值

  • 查询范围之间的值
    • 可以使用范围语法 n..n 搜索范围内的值,其中第一个数字 n 是最低值,而第二个是最高值
查询 示例
n..n vue stars:10…50 匹配含有 ‘vue’ 字样、有 10 到 50 个星号的仓库

查询日期

  • 查询日期
    • 可以通过使用 >、>=、<、<= 和 范围查询 搜索早于或晚于另一个日期,或者位于日期范围内的日期

日期格式必须遵循 ISO8601 标准,即 YYYY-MM-DD(年-月-日)

查询 示例
>YYYY-MM-DD vue created:>2016-04-29 匹配含有 “vue” 字样、在 2016 年 4 月 29 日之后创建的议题
>=YYYY-MM-DD vue created:>=2017-04-01 匹配含有 “vue” 字样、在 2017 年 4 月 1 日或之后创建的议题
<YYYY-MM-DD vue pushed:<2012-07-05 匹配在 2012 年 7 月 5 日之前推送的仓库中含有 ‘vue’ 字样的代码
<=YYYY-MM-DD vue created:<=2012-07-04 匹配含有 “vue” 字样、在 2012 年 7 月 4 日或之前创建的议题
YYYY-MM-DD..YYYY-MM-DD vue pushed:2016-04-30…2016-07-04 匹配含有 “vue” 字样、在 2016 年 4 月末到 7 月之间推送的仓库
YYYY-MM-DD.. vue created:2012-04-30…* 匹配在 2012 年 4 月 30 日之后创建、含有 ‘vue’ 字样的议题
..YYYY-MM-DD vue created:*…2012-04-30 匹配在 2012 年 7 月 4 日之前创建、含有 ‘vue’ 字样的议题

也可以在日期后添加可选的时间信息 THH:MM:SS+00:00,以便按小时、分钟和秒进行搜索。这是 T,随后是 HH:MM:SS(时-分-秒)和 UTC 偏移 (+00:00)

查询 示例
YYYY-MM-DDTHH:MM:SS+00:00 vue created:2017-01-01T01:00:00+07:00…2017-03-01T15:30:15+07:00 匹配在 2017 年 1 月 1 日凌晨 1 点(UTC 偏移为 07:00)与 2017 年 3 月 1 日下午 3 点(UTC 偏移为 07:00)之间创建的议题。UTC 偏移量 07:00,2017 年 3 月 1 日下午 3 点。UTC 偏移量 07:00
YYYY-MM-DDTHH:MM:SSZ vue created:2016-03-21T14:11:00Z…2016-04-07T20:45:00Z 匹配在 2016 年 3 月 21 日下午 2:11 与 2016 年 4 月 7 日晚上 8:45 之间创建的议题

排除特定结果

  • 排除特定结果
    • 可以使用 NOT 语法排除包含特定字词的结果。NOT 运算符只能用于字符串关键词,不适用于数字或日期
查询 示例
NOT hello NOT world 匹配含有 ‘hello’ 字样但不含有 ‘world’ 字样的仓库

缩小搜索结果范围的另一种途径是排除特定的子集,可以为任何搜索限定符添加 - 前缀,以排除该限定符匹配的所有结果

查询 示例
-QUALIFIER vue stars:>10 -language:javascript 匹配含有 ‘vue’ 字样、有超过 10 个星号但并非以 JavaScript 编写的仓库
mentions:biaochenxuying -org:github 匹配提及 @biaochenxuying 且不在 GitHub 组织仓库中的议题

对带有空格的查询使用引号

  • 对带有空格的查询使用引号
    • 如果搜索含有空格的查询,需要用引号将其括起来,例如:
      • vue NOT ‘hello world’ 匹配含有 ‘vue’ 字样但不含有 ‘hello world’ 字样的仓库
      • build label:‘bug fix’ 匹配具有标签 ‘bug fix’、含有 ‘build’ 字样的议题

某些非字母数字符号(例如空格)会从引号内的代码搜索查询中删除,因此结果可能出乎意料

使用用户名的查询

  • 使用用户名的查询
    • 如果搜索查询包含需要用户名的限定符,例如 user、actor 或 assignee,可以使用任何 GitHub 用户名指定特定人员,或使用 @me 指定当前用户
查询 示例
QUALIFIER:USERNAME author:biaochenxuying 匹配 @biaochenxuying 创作的提交
QUALIFIER:@me is:issue assignee:@me 匹配已分配给结果查看者的议题

@me 只能与限定符一起使用,而不能用作搜索词,例如 @me main.workflow

高级的搜索

按仓库名称、说明或自述文件内容搜索

  • 按仓库名称、说明或自述文件内容搜索
    • 通过 in 限定符,可以将搜索限制为仓库名称、仓库说明、自述文件内容或这些的任意组合

如果省略此限定符,则只搜索仓库名称和说明

限定符 示例
in:name vue in:name 匹配其名称中含有 ‘jquery’ 的仓库
in:description vue in:name,description 匹配其名称或说明中含有 ‘vue’ 的仓库
in:readme vue in:readme 匹配其自述文件中提及 ‘vue’ 的仓库
repo:owner/name repo:biaochenxuying/blog 匹配特定仓库名称,比如:用户为 biaochenxuying 的 blog 项目

在用户或组织的仓库内搜索

  • 在用户或组织的仓库内搜索
    • 要在 特定用户或组织 拥有的所有仓库中搜索,可以使用 user 或 org 限定符
限定符 示例
user:USERNAME user:biaochenxuying forks:>=100 匹配来自 @biaochenxuying、拥有超过 100 复刻的仓库
org:ORGNAME org:github 匹配来自 GitHub 的仓库

按仓库大小搜索

  • 按仓库大小搜索
    • size 限定符使用 大于、小于和范围限定符 查找匹配特定大小(以千字节为单位)的仓库
限定符 示例
size:n size:1000 匹配恰好为 1 MB 的仓库
size:>=30000 匹配至少为 30 MB 的仓库
size:<50 匹配小于 50 KB 的仓库
size:50…120 匹配介于 50 KB 与 120 KB 之间的仓库

按关注者数量搜索

  • 按关注者数量搜索
    • 可以使用 followers 限定符以及大于、小于和范围限定符基于仓库拥有的关注者数量过滤仓库
限定符 示例
followers:n node followers:>=10000 匹配有 10,000 或更多关注者提及文字 ‘node’ 的仓库
styleguide linter followers:1…10 匹配拥有 1 到 10 个关注者并且提及 ‘styleguide linter’ 一词的的仓库

按复刻数量搜索

  • 按复刻数量搜索
    • forks 限定符使用大于、小于和范围限定符指定仓库应具有的复刻数量
限定符 示例
forks:n forks:5 匹配只有 5 个复刻的仓库
forks:>=205 匹配具有至少 205 个复刻的仓库
forks:<90 匹配具有少于 90 个复刻的仓库
forks:10…20 匹配具有 10 到 20 个复刻的仓库

按星号数量搜索

  • 按星号数量搜索
    • 可以使用 大于、小于和范围限定符 基于仓库具有的 星标 数量搜索仓库
限定符 示例
stars:n stars:500 匹配恰好具有 500 个星号的仓库
stars:10…20 匹配具有 10 到 20 个星号、小于 1000 KB 的仓库
stars:>=500 fork:true language:vue 匹配具有至少 500 个星号,包括复刻的星号(以 vue 编写)的仓库

按仓库创建或上次更新时间搜索

  • 按仓库创建或上次更新时间搜索
    • 可以基于创建时间或上次更新时间过滤仓库
      • 对于仓库创建,可以使用 created 限定符
      • 要了解仓库上次更新的时间,要使用 pushed 限定符,pushed 限定符将返回仓库列表,按仓库中任意分支上最近进行的提交排序

两者均采用日期作为参数,日期格式必须遵循 ISO8601 标准,即 YYYY-MM-DD(年-月-日)

也可以在日期后添加可选的时间信息 THH:MM:SS+00:00,以便按小时、分钟和秒进行搜索。这是 T,随后是 HH:MM:SS(时-分-秒)和 UTC 偏移 (+00:00)

日期支持 大于、小于和范围限定符

限定符 示例
created:YYYY-MM-DD vue created:<2020-01-01 匹配具有 ‘vue’ 字样、在 2020 年之前创建的仓库
pushed:YYYY-MM-DD css pushed:>2020-02-01 匹配具有 ‘css’ 字样、在 2020 年 1 月之后收到推送的仓库
vue pushed:>=2020-03-06 fork:only 匹配具有 ‘vue’ 字样、在 2020 年 3 月 6 日或之后收到推送并且作为复刻的仓库

按语言搜索

  • 按语言搜索
    • 可以基于其编写采用的主要语言搜索仓库
限定符 示例
language:LANGUAGE vue language:javascript 匹配具有 ‘vue’ 字样、以 JavaScript 编写的仓库

按主题搜索

  • 按主题搜索
    • 可以查找归类为特定 主题 的所有仓库
限定符 示例
topic:TOPIC topic:algorithm 匹配已归类为 ‘algorithm’ 主题的仓库

估计有很多人和我一样不知道 GitHub 上有话题一说的吧

按主题数量搜索

  • 按主题数量搜索
    • 可以使用 topics 限定符以及 大于、小于和范围限定符 按应用于仓库的 主题 数量搜索仓库
限定符 示例
topics:n topics:5 匹配具有五个主题的仓库
topics:>3 匹配超过三个主题的仓库

使用可视界面搜索

  • 使用可视界面搜索
    • 还可以使用 search page 或 advanced search page 搜索 GitHub
      这种搜索方式,估计就更少人知道了吧
      advanced search page 提供用于构建搜索查询的可视界面
    • 可以按各种因素过滤搜索,例如仓库具有的星标数或复刻数,在填写高级搜索字段时,查询将在顶部搜索栏中自动构建

按许可搜索

  • 按许可搜索
    • 可以按其许可搜索仓库,必须使用许可关键词按特定许可或许可系列过滤仓库
限定符 示例
license:LICENSE_KEYWORD license:apache-2.0 匹配根据 Apache License 2.0 授权的仓库

按公共或私有仓库搜索

  • 按公共或私有仓库搜索
    • 可以基于仓库是公共还是私有来过滤搜索
限定符 示例
is:public is:public org:github 匹配 GitHub 拥有的公共仓库
is:private is:private pages 匹配您有访问权限且包含 ‘pages’ 字样的私有仓库

按公共或私有仓库搜索

  • 按公共或私有仓库搜索
    • 可以根据仓库是否为镜像以及托管于其他位置托管来搜索它们
限定符 示例
mirror:true mirror:true GNOME 匹配是镜像且包含 ‘GNOME’ 字样的仓库
mirror:false mirror:false GNOME 匹配并非镜像且包含 ‘GNOME’ 字样的仓库

基于仓库是否已存档搜索

  • 基于仓库是否已存档搜索
    • 可以基于仓库是否已存档来搜索仓库
限定符 示例
archived:true archived:true GNOME 匹配已存档且包含 ‘GNOME’ 字样的仓库
archived:false archived:false GNOME 匹配未存档且包含 ‘GNOME’ 字样的仓库

总结

其实,以上很多内容的都是来自于 GitHub 的官方文档,如果你还想学习更多技巧,请看 GitHub 官方文档: https://docs.github.com/cn

原创

GitHub 高级搜索语法

本文链接: GitHub 高级搜索语法

本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

评论交流

文章目录