如果你是一名前端开发人员并且使用过 Git，你可能知道 Git 提供的一些非常有用的命令行工具，如 git log、git grep 等。但是，这些工具有时限制比较大，例如 git log 只能过滤某个作者或某段时间提交的信息，而无法按多种条件进行筛选。这时，git-query 就是我们需要的工具了。
git-query 简介
git-query 是一个基于 Git 的命令行工具，它可以通过类 SQL 的语法从 Git 日志中筛选出我们需要的内容。它包含了许多有用的筛选方式，如：按照作者、时间、提交信息、变更行数等进行筛选。因为使用类 SQL 的语法，所以比较容易上手，只需要知道一些简单语法和参数即可开始使用。git-query 还提供了详尽的帮助文档，如果你遇到问题，可以随时查阅。
安装
npm install -g git-query
使用方法
基本用法
比如，我们想要查找某个仓库中，所有由你提交的、在 2021 年 9 月之前的提交，并且提交信息包含“feature”的提交记录。
首先，在命令行输入： git query "SELECT * FROM log WHERE author='你的名字' AND date<'2021-10-01' AND message LIKE '%feature%';"
参数
git-query 包含如下参数：
--repo / -r
指定需要查询的 Git 仓库，默认为当前目录。
--limit / -l
指定查询的结果数量，默认为 10。
--no-pager / -n
禁用 git log 的默认分页器，防止部分输出被截断。
--pretty / -p
指定输出格式，支持如下参数：
- “oneline”：输出每个提交的简洁信息，例如“091d0f7 commit message”。
- “short”：输出每个提交的较详细信息，例如提交作者、提交时间、提交信息等。
- “medium”：输出每个提交的较详细信息，并在信息下方附上变更内容的摘要信息。
- “full”：输出每个提交的较详细信息，并在信息下方附上变更内容的完整信息。
- “fuller”：输出每个提交的较详细信息，包括变更内容的完整信息以及作者、日期。
--json / -j
默认情况下，git-query 使用类 SQL 的语法输出结果。如果你需要以 JSON 格式输出，可以添加该参数。
语法说明
下面是 git-query 的基本语法：
--- ----- ------- ------- ---- --- ----- ------------
列名
git-query 支持如下列名：
- “message”：提交信息。
- “author”：作者。
- “email”：作者的邮箱。
- “date”：提交日期，格式为 YYYY-MM-DD。
- “datetime”：提交时间，格式为 YYYY-MM-DDTHH:mm:ss。
条件
git-query 支持下列条件：
- “=”：等于。
- “!=”：不等于。
- “<”：小于。
- “>”：大于。
- “<=”：小于等于。
- “>=”：大于等于。
- “LIKE”：匹配字符串（支持通配符“%”和“_”）。
- “IN”：匹配列表中的值。
逻辑运算符
git-query 支持逻辑运算符：
- “AND”：逻辑与。
- “OR”：逻辑或。
- “NOT”：逻辑非。
字符串
如果你需要在条件中使用字符串，需要使用单引号或双引号括起来，例如：
--- ----- ------- - ---- --- ----- ------------ --------
数字
如果你需要在条件中使用数字，不需要使用引号括起来：
--- ----- ------- - ---- --- ----- -----------------
日期
如果你需要在条件中使用日期，需要使用以下格式：
----------
例如：
--- ----- ------- - ---- --- ----- -----------------
列名
在查询语句中可以使用列名，例如：
--- ----- ------- -------------- ---- --- ----- ------------ ------ --- -----------------
操作符
git-query 支持各种操作符，例如：
>、<、=、!=
git query "SELECT * FROM log WHERE date>=2017-01-01 AND message!='Initial commit';"
LIKE
git query "SELECT * FROM log WHERE message LIKE '%feature%';"
IN
git query "SELECT * FROM log WHERE author IN ('John Smith','Jane Smith');"
限制显示数量
你可以使用 LIMIT 参数限制显示的数量，例如：
--- ----- ------- - ---- --- ----- ------------ ------ ----- ----
排序
你可以使用 ORDER BY 参数对筛选结果进行排序，例如：
--- ----- ------- - ---- --- ----- -- ---- ---- ----- ----
帮助文档
在命令行中输入以下命令可以查看 git-query 的帮助文档：
--- ----- -----
示例代码
下面是一个示例代码，该代码从 Git 日志中查询所有提交者不是“John Smith”或“Jane Smith”的提交记录：
--- ----- ------- - ---- --- ----- ------ --- -- ------ ------- ----- ---------
结论
使用 git-query 可以非常方便地从 Git 日志中筛选出我们想要的内容，大大提高了开发效率。相信这篇教程可以帮助你快速上手 git-query，并从中受益。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/600557bf81e8991b448d4c95