gh search commits
gh search commits [<query>] [flags]
在 GitHub 上搜索提交。
该命令支持使用 GitHub 搜索语法、参数和限定符标志或两者的组合构建查询。
GitHub 搜索语法在以下位置有记录：https://docs.github.com/search-github/searching-on-github/searching-commits
选项
-
--author <string> - 按作者筛选
-
--author-date <date> - 根据作者日期筛选
-
--author-email <string> - 按作者电子邮件筛选
-
--author-name <string> - 按作者姓名筛选
-
--committer <string> - 按提交者筛选
-
--committer-date <date> - 根据提交日期筛选
-
--committer-email <string> - 按提交者电子邮件筛选
-
--committer-name <string> - 按提交者姓名筛选
-
--hash <string> - 按提交哈希值筛选
-q,--jq <expression>- 使用 jq 表达式过滤 JSON 输出
-
--json <fields> - 使用指定的字段输出 JSON
-L,--limit <int> (default 30)- 要获取的提交的最大数量
-
--merge - 按合并提交筛选
-
--order <string> (default "desc") - 返回的提交顺序，除非指定“--sort”标志，否则将被忽略：{asc|desc}
-
--owner <strings> - 按仓库所有者筛选
-
--parent <string> - 按父哈希值筛选
-R,--repo <strings>- 按仓库筛选
-
--sort <string> (default "best-match") - 对获取的提交进行排序：{author-date|committer-date}
-t,--template <string>- 使用 Go 模板格式化 JSON 输出；请参阅“gh help formatting”
-
--tree <string> - 按树哈希值筛选
-
--visibility <strings> - 根据仓库可见性筛选：{public|private|internal}
-w,--web- 在 Web 浏览器中打开搜索查询
JSON 字段
author, commit, committer, id, parents, repository, sha, url
示例
# search commits matching set of keywords "readme" and "typo"
$ gh search commits readme typo
# search commits matching phrase "bug fix"
$ gh search commits "bug fix"
# search commits committed by user "monalisa"
$ gh search commits --committer=monalisa
# search commits authored by users with name "Jane Doe"
$ gh search commits --author-name="Jane Doe"
# search commits matching hash "8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3"
$ gh search commits --hash=8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3
# search commits authored before February 1st, 2022
$ gh search commits --author-date="<2022-02-01"