尧图网站建设 
ripgrep 的 grep-printer 深度解析搜索结果如何被渲染成人类可读、汇总与 JSON Lines 三种格式【免费下载链接】ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore项目地址: https://gitcode.com/GitHub_Trending/ri/ripgrep在 ripgrep 的架构中搜到什么matcher与怎么输出printer被严格解耦grep-searcher负责扫描数据流并报告匹配与上下文行而grep-printercrate 位于 crates/printer则实现了Sink回调把流式搜索结果渲染为三类输出——人类可读的标准格式、聚合的汇总格式Summary以及机器可读的 JSON Lines 格式。读完本文你将掌握这三种打印器的 API 与全部可配置项分隔符、颜色、超链接、统计等并理解 ripgrep 输出格式的底层实现机制从而能独立用grep-printer构建自己的搜索工具或解析rg --json的输出。一、crate 定位与使用方式crates/printer/README.md 对该 crate 的定义是Print results from line oriented searching in a human readable, aggregate or JSON Lines format.即从面向行的搜索中打印结果支持人类可读、聚合aggregate或 JSON Lines 三种格式。README 同时给出了一条重要提示——你通常不需要直接使用这个 crate而应优先使用 grep 门面facadecrate。从 grep 库的实现 可以确认这一点它通过pub extern crate再导出grep_printer作为printer、grep_searcher作为searcher等全部核心 crate使用方只需依赖grep一个 crate 即可获得完整能力。README 中给出的依赖声明为[dependencies] grep-printer 0.1需要注意适用前提该 README 示例中的版本号 0.1 并未随版本迭代更新。以当前仓库的 crates/printer/Cargo.toml 为准crate 实际版本为0.3.1version 0.3.1且声明了default [serde]特性——JSON 打印器的实现依赖serde/serde_json因此在启用默认特性下即可获得完整的 JSON 输出能力。该 crate 的核心导出见 crates/printer/src/lib.rs为三组打印器及其配套类型导出项所在模块输出格式Standard/StandardBuilder/StandardSinkstandard.rs人类可读的 grep 风格输出Summary/SummaryBuilder/SummaryKindsummary.rs聚合汇总计数、路径列表、静默探测JSON/JSONBuilder/JSONSink需serde特性json.rsJSON Lines 流式消息ColorSpecs/UserColorSpec/default_color_specscolor.rs终端配色规范HyperlinkConfig/HyperlinkFormat等hyperlink/mod.rs终端超链接格式Statsstats.rs搜索统计信息lib.rs的模块级文档还给出了最小可用示例用Standard::new_no_color创建一个无颜色打印器把 sink 交给Searcher执行搜索最后通过into_inner()两次取回底层缓冲区得到输出文本1:For the Doctor Watsons.../3:be, to a very large extent...。二、Standard 打印器grep 风格输出的全部配置面Standard打印器模仿标准 grep 类工具的格式功能覆盖跨平台终端着色、搜索与替换、多行结果处理和统计摘要见 lib.rs 的 crate 文档。其配置集中在StandardBuilder的私有Config结构体中standard.rs 第 30-84 行builder 构建后配置即冻结、不可再修改。2.1 分隔符体系grep 输出path:line_number:matched_line或path-line_number-context_line中的每一个符号都是可配置的builder 方法作用默认值separator_field_match匹配行的字段分隔符行号与内容之间:separator_field_context上下文行的字段分隔符-separator_context不连续上下文组之间的分隔符独占一行--separator_search不同搜索结果集之间的分隔符禁用separator_path打印文件路径时使用的路径分隔符字节系统默认Cygwin 用户可设为/path_terminator每条文件路径之后追加的终止字节无这套分隔符正是 ripgrep 与 GNU grep 输出兼容性的来源文档注释明确说明要复现经典 grep 格式通常在有上下文行时把separator_search设为--。2.2 匹配呈现方式一组布尔开关控制输出什么heading(bool)启用后文件路径单独占一行作为标题而不是作为每行结果的前缀path(bool)是否打印文件路径默认开启only_matching(bool)只打印匹配片段本身每个匹配独占一行多行模式下只显示各参与行的匹配部分——对应rg -oper_match(bool)每个匹配至少打印一行完整行常与column联用显示每个匹配的起始列——对应rg -A/-B类的按匹配展开语义per_match_one_line(bool)多行匹配下每个匹配只打印首行max_columns(Optionu64)按字节计的行宽上限超出的行整体省略并提示max_columns_preview(bool)改为打印前 N 个图元簇的预览对应rg --max-columns --max-columns-previewcolumn(bool)/byte_offset(bool)分别打印行内首匹配的列号按字节计与行起始的绝对字节偏移0 基从本次搜索起点计trim_ascii(bool)打印前去除行首 ASCII 空白replacement(OptionVecu8):对匹配做替换输出替换串支持$2索引与$name命名捕获组插值插值格式由grep-matcher的Capture::interpolate定义对应rg -r。2.3 何时需要逐匹配粒度一个值得注意的实现细节StandardSink持有一个needs_match_granularity标志standard.rs 的needs_match_granularity方法其逻辑为——当着色可用且配置了 match 颜色、或启用了column、replacement、per_match、only_matching、stats中任意一项时sink 必须对每个报告行额外执行一遍 matcher 来定位每个独立匹配的位置否则 searcher 报告的行级结果已足够可跳过这次昂贵的重复搜索。从源码结构看这是 ripgrep 在无颜色快速路径与彩色/替换慢速路径之间的性能优化点。2.4 颜色规范UserColorSpec颜色通过UserColorSpec字符串配置格式为{type}:{attribute}:{value}三元组color.rs 的文档{type}path、line、column、match、highlight之一{attribute}fg、bg、style或特殊值none清除该类型的样式{value}省略{value}颜色名black/blue/green/red/cyan/magenta/yellow/white、256 色x、24 位真彩色x,x,x十进制或0x前缀十六进制或样式指令bold、nobold、intense、nointense、underline、nounderline、italic、noitalic。示例文档内测试代码let user_spec1: UserColorSpec path:fg:blue.parse().unwrap(); let user_spec2: UserColorSpec match:bg:0xff,0x7f,0x00.parse().unwrap();多条 spec 会合并进一个ColorSpecs后加入的覆盖先加入的。内置默认调色板由default_color_specs()提供且按平台区分vec![ #[cfg(unix)] path:fg:magenta.parse().unwrap(), #[cfg(windows)] path:fg:cyan.parse().unwrap(), line:fg:green.parse().unwrap(), match:fg:red.parse().unwrap(), match:style:bold.parse().unwrap(), ]即 Unix 下路径为洋红、Windows 下为青色行号为绿色匹配片段红色加粗。必须强调颜色规范只决定该用什么颜色是否真正输出颜色取决于build时传入的termcolor::WriteColor实现——传入NoColor则永不输出颜色Standard::new_no_color正是build(NoColor::new(wtr))的便捷封装。2.5 终端超链接StandardBuilder::hyperlink接受HyperlinkConfig由 hyperlink/mod.rs 实现。HyperlinkFormat可用字符串解析构造默认格式为空等价于禁用超链接格式中可内插{path}、{line}、{column}等变量。crate 内置了一批知名编辑器的 scheme 别名hyperlink/aliases.rs包括cursorcursor://file{path}:{line}:{column}、defaultRFC 8089 的file://平台感知非 Windows 带{host}、file、grepgrep://{path}:{line}、kittyfile://{host}{path}#{line}、macvimmvim://open?url...、textmatetxmt://open?url...、vscodevscode://file{path}:{line}:{column}、vscode-insiders、vscodium以及none显式禁用。这与 ripgrep 的--hyperlink-format标志一一对应。2.6 统计信息StatsStandardBuilder::stats(true)开启后sink 可经StandardSink::stats()获取聚合统计。Stats结构stats.rs维护七个字段elapsed总耗时、searches搜索次数、searches_with_match有匹配的搜索次数、bytes_searched搜索的总字节数、bytes_printed打印的总字节数、matched_lines参与匹配的总行数多行匹配时计入每一行、matches总匹配数。实现上字节数由CounterWriter包装器在每次写操作时累加得到文档也明确警告开启统计可能需要额外工作、使搜索变慢对应rg --stats。三、Summary 打印器聚合输出的六种模式Summary打印器summary.rs面向单次搜索的聚合结果——通常只输出一行。其核心是SummaryKind枚举六种模式分别对应 ripgrep 的不同标志模式语义早停特性对应 rg 标志Count匹配行计数每行至多计一次有 path 时以路径为前缀不可-cCountMatches匹配总次数计数同一行可计多次不可-m组合计数PathWithMatch找到匹配才打印文件路径可首匹配即停-lPathWithoutMatch未找到匹配才打印文件路径不可-LQuietWithMatch有匹配即静默停止搜索可-qQuietWithoutMatch出现无匹配文件即静默停止不可反向探测源码中两个辅助方法揭示了其内部约束requires_path()表明PathWithMatch/PathWithoutMatch两种模式强制要求提供文件路径否则每次搜索开始时直接报错requires_stats()表明只有CountMatches必须内部计算统计因为它需要逐匹配计数其余模式不需要quit_early()则定义了PathWithMatch/QuietWithMatch可在首个匹配后短路搜索。Summary 打印器默认值还包括kind Count、path true、exclude_zero true计数为 0 时不输出、字段分隔符:。四、JSON 打印器JSON Lines 协议与编码细节JSON打印器json.rs面向机器消费采用 JSON Lines 协议搜索过程中逐条流式发射单行 JSON 消息。其文档该文件第 120-484 行是 ripgrep--json输出的权威规格说明。4.1 四类消息与信封格式每条消息包在一个统一信封中{type: {begin|end|match|context}, data: { ... }}。begin文件开始被搜索字段仅path无路径时为nullend搜索结束含path、binary_offset检测到二进制数据的位置无则null、stats见 2.6 的统计对象match发现匹配字段有path、lines、line_numbersearcher 启用行号时才有否则null、absolute_offset行起始的绝对字节偏移、submatches子匹配数组按起始偏移排序反向搜索时可为空context上下文行字段与 match 完全相同。反向搜索时上下文行的submatches可能非空因为原始 matcher 能在上下文行中命中。submatch对象含match匹配文本、start/end对父对象lines字段的半开区间字节偏移start end若lines为 base64 编码则偏移针对解码后数据、可选的replacement配置了替换文本时。4.2 文本编码text/bytes 双字段约定这是该协议中最容易被外部消费者忽略的健壮性设计JSON 只允许 UTF-8/16/32 编码但搜索数据与文件路径都不保证是合法 UTF-8。打印器绝不做有损转码替换为 UFFFD而是约定合法 UTF-8 用text键非法字节整体 base64 编码后用bytes键承载{path: {text: /home/ubuntu/lib.rs}} // 若路径含 \xFF 非法字节 {path: {bytes: L2hvbWUvdWJ1bnR1L2xpYv8ucnM}}打印器保证底层字节合法 UTF-8 时一定使用text字段。4.3 完整消息流示例crate 文档以tests中同源的 sherlock 语料为例文件位于/home/andrew/sherlock搜索Watson、before_context1、启用行号同一条搜索的标准输出是sherlock:1:For the Doctor Watsons of this world, as opposed to the Sherlock -- sherlock-4-can extract a clew from a wisp of straw or a flake of cigar ash; sherlock:5:but Doctor Watson has to have it taken out for him and dusted,而 JSON 打印器发射的消息流示意性美化排版实际为每消息一行为begin含路径→match第 1 行submatches中Watson位于start: 15, end: 21→context第 4 行submatches为空absolute_offset: 193→match第 5 行Watson位于11..17→endbinary_offset: nullstats 中bytes_searched: 367、bytes_printed: 1151、matched_lines: 2、matches: 2。配置了替换文本Moriarity时submatch对象中会额外携带{replacement: {text: Moriarity}}。4.4 builder 选项与实现要点JSONBuilder只有三个可配置项结构化格式下打印机总是尝试获取尽可能多的信息故配置面更小pretty(bool)美化输出此时不再是严格 JSON Lines单条消息可跨多行、always_begin_end(bool)默认关闭仅当存在至少一条 match/context 消息时才发 begin/end开启则无论如何都发、replacement(OptionVecu8)。从 json.rs 的Sink实现可见matched()回调递增match_count、懒写 begin 消息、记录子匹配并构造jsont::Message::Matchfinish()汇总统计后写 end 消息binary_data()回调仅在debug日志级别记录二进制偏移并继续。另外有个微妙的性能细节SubMatches用三态枚举Empty/Small([..;1])/Big(Vec..)特化恰好一个匹配的常见情形避免堆分配。该模块内嵌的测试binary_detection、max_matches、max_matches_after_context等验证了二进制偏移上报、max_matches截断后消息计数等关键行为可作为协议行为的回归依据。五、三类打印器的取舍与组合建议结合 crates/printer/README.md 的定位与源码实现可以归纳出使用grep-printer时的三条实践原则优先走门面新代码应依赖 grep crate它再导出printer/searcher/matcher/regex避免直接依赖grep-printer造成版本组合困难——这是 README 的原始建议且门面 crate 在仓库中确实如此实现。builder 构建后配置冻结Standard/JSON/Summary三者都是Builder 改配置 →build产出不可变配置的打印机且每次搜索应通过sink(matcher)/sink_with_path(matcher, path)创建廉价的新 sink搜索结束后可查询has_match()、match_count()、binary_byte_offset()、stats()等只读结果。格式选择按消费方人看选Standard配ColorSpecsHyperlinkConfig获得着色与可点击路径写脚本探测存在性选SummaryQuietWithMatch等价于-q短路供程序解析选JSON消费方必须实现text/bytes双字段解码约定并注意line_number可能为null、submatches可能为空这两个文档明确声明的边界情况。以上所有行为均可在当前仓库内复核打印器导出与示例见 crates/printer/src/lib.rs三种打印器分别对应 crates/printer/src/standard.rs、crates/printer/src/summary.rs、crates/printer/src/json.rs颜色与超链接规格分别在 crates/printer/src/color.rs 与 crates/printer/src/hyperlink/aliases.rscrate 版本与serde特性见 crates/printer/Cargo.toml。【免费下载链接】ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore项目地址: https://gitcode.com/GitHub_Trending/ri/ripgrep创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ripgrep 的 grep-printer 深度解析：搜索结果如何被渲染成人类可读、汇总与 JSON Lines 三种格式
ripgrep 的 grep-printer 深度解析搜索结果如何被渲染成人类可读、汇总与 JSON Lines 三种格式【免费下载链接】ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore项目地址: https://gitcode.com/GitHub_Trending/ri/ripgrep在 ripgrep 的架构中搜到什么matcher与怎么输出printer被严格解耦grep-searcher负责扫描数据流并报告匹配与上下文行而grep-printercrate 位于 crates/printer则实现了Sink回调把流式搜索结果渲染为三类输出——人类可读的标准格式、聚合的汇总格式Summary以及机器可读的 JSON Lines 格式。读完本文你将掌握这三种打印器的 API 与全部可配置项分隔符、颜色、超链接、统计等并理解 ripgrep 输出格式的底层实现机制从而能独立用grep-printer构建自己的搜索工具或解析rg --json的输出。一、crate 定位与使用方式crates/printer/README.md 对该 crate 的定义是Print results from line oriented searching in a human readable, aggregate or JSON Lines format.即从面向行的搜索中打印结果支持人类可读、聚合aggregate或 JSON Lines 三种格式。README 同时给出了一条重要提示——你通常不需要直接使用这个 crate而应优先使用 grep 门面facadecrate。从 grep 库的实现 可以确认这一点它通过pub extern crate再导出grep_printer作为printer、grep_searcher作为searcher等全部核心 crate使用方只需依赖grep一个 crate 即可获得完整能力。README 中给出的依赖声明为[dependencies] grep-printer 0.1需要注意适用前提该 README 示例中的版本号 0.1 并未随版本迭代更新。以当前仓库的 crates/printer/Cargo.toml 为准crate 实际版本为0.3.1version 0.3.1且声明了default [serde]特性——JSON 打印器的实现依赖serde/serde_json因此在启用默认特性下即可获得完整的 JSON 输出能力。该 crate 的核心导出见 crates/printer/src/lib.rs为三组打印器及其配套类型导出项所在模块输出格式Standard/StandardBuilder/StandardSinkstandard.rs人类可读的 grep 风格输出Summary/SummaryBuilder/SummaryKindsummary.rs聚合汇总计数、路径列表、静默探测JSON/JSONBuilder/JSONSink需serde特性json.rsJSON Lines 流式消息ColorSpecs/UserColorSpec/default_color_specscolor.rs终端配色规范HyperlinkConfig/HyperlinkFormat等hyperlink/mod.rs终端超链接格式Statsstats.rs搜索统计信息lib.rs的模块级文档还给出了最小可用示例用Standard::new_no_color创建一个无颜色打印器把 sink 交给Searcher执行搜索最后通过into_inner()两次取回底层缓冲区得到输出文本1:For the Doctor Watsons.../3:be, to a very large extent...。二、Standard 打印器grep 风格输出的全部配置面Standard打印器模仿标准 grep 类工具的格式功能覆盖跨平台终端着色、搜索与替换、多行结果处理和统计摘要见 lib.rs 的 crate 文档。其配置集中在StandardBuilder的私有Config结构体中standard.rs 第 30-84 行builder 构建后配置即冻结、不可再修改。2.1 分隔符体系grep 输出path:line_number:matched_line或path-line_number-context_line中的每一个符号都是可配置的builder 方法作用默认值separator_field_match匹配行的字段分隔符行号与内容之间:separator_field_context上下文行的字段分隔符-separator_context不连续上下文组之间的分隔符独占一行--separator_search不同搜索结果集之间的分隔符禁用separator_path打印文件路径时使用的路径分隔符字节系统默认Cygwin 用户可设为/path_terminator每条文件路径之后追加的终止字节无这套分隔符正是 ripgrep 与 GNU grep 输出兼容性的来源文档注释明确说明要复现经典 grep 格式通常在有上下文行时把separator_search设为--。2.2 匹配呈现方式一组布尔开关控制输出什么heading(bool)启用后文件路径单独占一行作为标题而不是作为每行结果的前缀path(bool)是否打印文件路径默认开启only_matching(bool)只打印匹配片段本身每个匹配独占一行多行模式下只显示各参与行的匹配部分——对应rg -oper_match(bool)每个匹配至少打印一行完整行常与column联用显示每个匹配的起始列——对应rg -A/-B类的按匹配展开语义per_match_one_line(bool)多行匹配下每个匹配只打印首行max_columns(Optionu64)按字节计的行宽上限超出的行整体省略并提示max_columns_preview(bool)改为打印前 N 个图元簇的预览对应rg --max-columns --max-columns-previewcolumn(bool)/byte_offset(bool)分别打印行内首匹配的列号按字节计与行起始的绝对字节偏移0 基从本次搜索起点计trim_ascii(bool)打印前去除行首 ASCII 空白replacement(OptionVecu8):对匹配做替换输出替换串支持$2索引与$name命名捕获组插值插值格式由grep-matcher的Capture::interpolate定义对应rg -r。2.3 何时需要逐匹配粒度一个值得注意的实现细节StandardSink持有一个needs_match_granularity标志standard.rs 的needs_match_granularity方法其逻辑为——当着色可用且配置了 match 颜色、或启用了column、replacement、per_match、only_matching、stats中任意一项时sink 必须对每个报告行额外执行一遍 matcher 来定位每个独立匹配的位置否则 searcher 报告的行级结果已足够可跳过这次昂贵的重复搜索。从源码结构看这是 ripgrep 在无颜色快速路径与彩色/替换慢速路径之间的性能优化点。2.4 颜色规范UserColorSpec颜色通过UserColorSpec字符串配置格式为{type}:{attribute}:{value}三元组color.rs 的文档{type}path、line、column、match、highlight之一{attribute}fg、bg、style或特殊值none清除该类型的样式{value}省略{value}颜色名black/blue/green/red/cyan/magenta/yellow/white、256 色x、24 位真彩色x,x,x十进制或0x前缀十六进制或样式指令bold、nobold、intense、nointense、underline、nounderline、italic、noitalic。示例文档内测试代码let user_spec1: UserColorSpec path:fg:blue.parse().unwrap(); let user_spec2: UserColorSpec match:bg:0xff,0x7f,0x00.parse().unwrap();多条 spec 会合并进一个ColorSpecs后加入的覆盖先加入的。内置默认调色板由default_color_specs()提供且按平台区分vec![ #[cfg(unix)] path:fg:magenta.parse().unwrap(), #[cfg(windows)] path:fg:cyan.parse().unwrap(), line:fg:green.parse().unwrap(), match:fg:red.parse().unwrap(), match:style:bold.parse().unwrap(), ]即 Unix 下路径为洋红、Windows 下为青色行号为绿色匹配片段红色加粗。必须强调颜色规范只决定该用什么颜色是否真正输出颜色取决于build时传入的termcolor::WriteColor实现——传入NoColor则永不输出颜色Standard::new_no_color正是build(NoColor::new(wtr))的便捷封装。2.5 终端超链接StandardBuilder::hyperlink接受HyperlinkConfig由 hyperlink/mod.rs 实现。HyperlinkFormat可用字符串解析构造默认格式为空等价于禁用超链接格式中可内插{path}、{line}、{column}等变量。crate 内置了一批知名编辑器的 scheme 别名hyperlink/aliases.rs包括cursorcursor://file{path}:{line}:{column}、defaultRFC 8089 的file://平台感知非 Windows 带{host}、file、grepgrep://{path}:{line}、kittyfile://{host}{path}#{line}、macvimmvim://open?url...、textmatetxmt://open?url...、vscodevscode://file{path}:{line}:{column}、vscode-insiders、vscodium以及none显式禁用。这与 ripgrep 的--hyperlink-format标志一一对应。2.6 统计信息StatsStandardBuilder::stats(true)开启后sink 可经StandardSink::stats()获取聚合统计。Stats结构stats.rs维护七个字段elapsed总耗时、searches搜索次数、searches_with_match有匹配的搜索次数、bytes_searched搜索的总字节数、bytes_printed打印的总字节数、matched_lines参与匹配的总行数多行匹配时计入每一行、matches总匹配数。实现上字节数由CounterWriter包装器在每次写操作时累加得到文档也明确警告开启统计可能需要额外工作、使搜索变慢对应rg --stats。三、Summary 打印器聚合输出的六种模式Summary打印器summary.rs面向单次搜索的聚合结果——通常只输出一行。其核心是SummaryKind枚举六种模式分别对应 ripgrep 的不同标志模式语义早停特性对应 rg 标志Count匹配行计数每行至多计一次有 path 时以路径为前缀不可-cCountMatches匹配总次数计数同一行可计多次不可-m组合计数PathWithMatch找到匹配才打印文件路径可首匹配即停-lPathWithoutMatch未找到匹配才打印文件路径不可-LQuietWithMatch有匹配即静默停止搜索可-qQuietWithoutMatch出现无匹配文件即静默停止不可反向探测源码中两个辅助方法揭示了其内部约束requires_path()表明PathWithMatch/PathWithoutMatch两种模式强制要求提供文件路径否则每次搜索开始时直接报错requires_stats()表明只有CountMatches必须内部计算统计因为它需要逐匹配计数其余模式不需要quit_early()则定义了PathWithMatch/QuietWithMatch可在首个匹配后短路搜索。Summary 打印器默认值还包括kind Count、path true、exclude_zero true计数为 0 时不输出、字段分隔符:。四、JSON 打印器JSON Lines 协议与编码细节JSON打印器json.rs面向机器消费采用 JSON Lines 协议搜索过程中逐条流式发射单行 JSON 消息。其文档该文件第 120-484 行是 ripgrep--json输出的权威规格说明。4.1 四类消息与信封格式每条消息包在一个统一信封中{type: {begin|end|match|context}, data: { ... }}。begin文件开始被搜索字段仅path无路径时为nullend搜索结束含path、binary_offset检测到二进制数据的位置无则null、stats见 2.6 的统计对象match发现匹配字段有path、lines、line_numbersearcher 启用行号时才有否则null、absolute_offset行起始的绝对字节偏移、submatches子匹配数组按起始偏移排序反向搜索时可为空context上下文行字段与 match 完全相同。反向搜索时上下文行的submatches可能非空因为原始 matcher 能在上下文行中命中。submatch对象含match匹配文本、start/end对父对象lines字段的半开区间字节偏移start end若lines为 base64 编码则偏移针对解码后数据、可选的replacement配置了替换文本时。4.2 文本编码text/bytes 双字段约定这是该协议中最容易被外部消费者忽略的健壮性设计JSON 只允许 UTF-8/16/32 编码但搜索数据与文件路径都不保证是合法 UTF-8。打印器绝不做有损转码替换为 UFFFD而是约定合法 UTF-8 用text键非法字节整体 base64 编码后用bytes键承载{path: {text: /home/ubuntu/lib.rs}} // 若路径含 \xFF 非法字节 {path: {bytes: L2hvbWUvdWJ1bnR1L2xpYv8ucnM}}打印器保证底层字节合法 UTF-8 时一定使用text字段。4.3 完整消息流示例crate 文档以tests中同源的 sherlock 语料为例文件位于/home/andrew/sherlock搜索Watson、before_context1、启用行号同一条搜索的标准输出是sherlock:1:For the Doctor Watsons of this world, as opposed to the Sherlock -- sherlock-4-can extract a clew from a wisp of straw or a flake of cigar ash; sherlock:5:but Doctor Watson has to have it taken out for him and dusted,而 JSON 打印器发射的消息流示意性美化排版实际为每消息一行为begin含路径→match第 1 行submatches中Watson位于start: 15, end: 21→context第 4 行submatches为空absolute_offset: 193→match第 5 行Watson位于11..17→endbinary_offset: nullstats 中bytes_searched: 367、bytes_printed: 1151、matched_lines: 2、matches: 2。配置了替换文本Moriarity时submatch对象中会额外携带{replacement: {text: Moriarity}}。4.4 builder 选项与实现要点JSONBuilder只有三个可配置项结构化格式下打印机总是尝试获取尽可能多的信息故配置面更小pretty(bool)美化输出此时不再是严格 JSON Lines单条消息可跨多行、always_begin_end(bool)默认关闭仅当存在至少一条 match/context 消息时才发 begin/end开启则无论如何都发、replacement(OptionVecu8)。从 json.rs 的Sink实现可见matched()回调递增match_count、懒写 begin 消息、记录子匹配并构造jsont::Message::Matchfinish()汇总统计后写 end 消息binary_data()回调仅在debug日志级别记录二进制偏移并继续。另外有个微妙的性能细节SubMatches用三态枚举Empty/Small([..;1])/Big(Vec..)特化恰好一个匹配的常见情形避免堆分配。该模块内嵌的测试binary_detection、max_matches、max_matches_after_context等验证了二进制偏移上报、max_matches截断后消息计数等关键行为可作为协议行为的回归依据。五、三类打印器的取舍与组合建议结合 crates/printer/README.md 的定位与源码实现可以归纳出使用grep-printer时的三条实践原则优先走门面新代码应依赖 grep crate它再导出printer/searcher/matcher/regex避免直接依赖grep-printer造成版本组合困难——这是 README 的原始建议且门面 crate 在仓库中确实如此实现。builder 构建后配置冻结Standard/JSON/Summary三者都是Builder 改配置 →build产出不可变配置的打印机且每次搜索应通过sink(matcher)/sink_with_path(matcher, path)创建廉价的新 sink搜索结束后可查询has_match()、match_count()、binary_byte_offset()、stats()等只读结果。格式选择按消费方人看选Standard配ColorSpecsHyperlinkConfig获得着色与可点击路径写脚本探测存在性选SummaryQuietWithMatch等价于-q短路供程序解析选JSON消费方必须实现text/bytes双字段解码约定并注意line_number可能为null、submatches可能为空这两个文档明确声明的边界情况。以上所有行为均可在当前仓库内复核打印器导出与示例见 crates/printer/src/lib.rs三种打印器分别对应 crates/printer/src/standard.rs、crates/printer/src/summary.rs、crates/printer/src/json.rs颜色与超链接规格分别在 crates/printer/src/color.rs 与 crates/printer/src/hyperlink/aliases.rscrate 版本与serde特性见 crates/printer/Cargo.toml。【免费下载链接】ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore项目地址: https://gitcode.com/GitHub_Trending/ri/ripgrep创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考