ugrep.com

ugrep是什么网站?

ugrep 是一个命令行文件搜索工具的官方网站，提供 ugrep 与 ug 两款命令，定位是“兼容 grep、功能更多、速度更快的 grep 替代品”。

主要用途

• 在文件与目录中按正则表达式搜索内容，兼容 grep 常用选项，可直接替换日常 grep 用法。
• 支持扩展 Unicode 正则、PCRE 语法和多行匹配，无需额外命令行选项。
• 搜索压缩包与嵌套压缩包（zip/7z/tar 等）及 gz、xz、zstd 等压缩文件。
• 搜索二进制文件并可十六进制输出，也能检索 PDF、doc、docx 等文档。
• 输出可选 grep 风格，或 JSON、XML、CSV 及自定义格式。
• 内置 TUI 交互界面，支持模糊搜索和逻辑组合模式。

使用场景

• 开发者在终端里做代码检索、日志排查，希望比 grep 更快、语法更强时用它。
• 需要一次性在压缩包、PDF 或二进制文件中查找内容时，用 ug+ 覆盖文档与电子书。
• 写 shell 脚本时用 ugrep 命令，它不读取 .ugrep 配置文件、不设默认选项，行为更可预期；日常手动搜索用 ug，可把偏好保存进 .ugrep 配置。

选择条件

• 只想要 grep 兼容且零学习成本：直接用 ugrep 命令。
• 想要更顺手的默认配置和文档搜索：用 ug 或 ug+。
• 需要图形化或编辑器内搜索：它不提供，属于纯命令行工具。

竞品侧重

与 ripgrep 相比，ugrep 更强调 grep 选项兼容、压缩包与文档搜索、多格式输出；ripgrep 常被用于代码库快速检索。与 ack、The Silver Searcher 相比，ugrep 覆盖面更广，包含二进制、压缩文件与交互式 TUI。安装方式覆盖 brew、apt、dnf、pacman、winget、choco 等主流包管理器。

ugrep和grep、ripgrep相比在搜索速度和兼容性上有什么区别?

ugrep 在兼容性上最接近 GNU grep，在速度上以“更快且结果可靠”为目标，但和 ripgrep 的取舍不同：ugrep 尽量保留 grep 的命令行习惯并扩展功能，ripgrep 则更偏向默认忽略规则、面向代码仓库的快速搜索。

速度上的区别

• ugrep 与 grep：ugrep 官方定位是“更快、更可靠的 grep 替代品”，并给出基准测试页面。日常小文件搜索差异不明显；在大目录、冷文件系统或需要索引时，ugrep 提供文件索引来加速冷 FS 搜索，这是传统 grep 不具备的。
• ugrep 与 ripgrep：两者都属于现代快速搜索工具，具体快慢取决于文件规模、正则复杂度、是否启用索引和忽略规则。建议在自己的目录上做一次对比：同一模式、同一目录、清空缓存后各跑几次，比只看宣传数字更可靠。
• 影响速度的常见因素：是否搜索压缩包和归档、是否启用索引、正则类型（固定字符串、扩展正则、PCRE）、是否多行匹配。ugrep 支持直接搜索嵌套的 zip/7z/tar 等归档和 gz/xz/zstd 等压缩文件，省去先解压再搜的步骤，但这类搜索本身会比纯文本慢。

兼容性上的区别

选择条件

• 已有大量 grep 脚本、希望少改命令就获得更快搜索和更多格式输出：选 ugrep，脚本里用 ugrep 避免读取个人配置。
• 需要搜压缩包、归档、PDF 或二进制内容：ugrep 的覆盖范围更直接。
• 主要在代码仓库里搜索、希望默认尊重 .gitignore、偏好开箱即用的现代默认值：ripgrep 更贴合这种工作流。
• 需要严格可移植的 POSIX 行为：直接用系统 grep 最稳妥，ugrep 和 ripgrep 都应视为替代工具而非完全等价。

例如需要在一堆含 zip 和 PDF 的资料目录里找关键词，ugrep 可以一条命令覆盖；而只搜 Git 仓库源码时，ripgrep 的默认忽略规则通常更省心。

如何在macOS、Windows或Linux上安装ugrep?

在 macOS、Windows 和 Linux 上安装 ugrep，最直接的方式是用系统自带的包管理器；官方页面按平台列出了对应命令。

各平台安装命令

从源码构建

若包管理器没有合适版本，可按官方步骤自行编译：

git clone https://github.com/Genivia/ugrep
cd ugrep
./build.sh        # 在 ugrep/bin 中构建 ug 和 ugrep
sudo make install

选择建议

• 优先用包管理器，升级和卸载都跟着系统走，最省事。
• 需要最新版本或平台没有现成包时，用源码构建或静态构建包。
• 安装后先运行 ugrep --version 确认版本；日常交互式搜索可用 ug 命令，脚本中则用不带默认配置的 ugrep。

ugrep的交互式TUI界面怎么使用?

ugrep 的交互式 TUI 是 ug 命令的默认界面，不传文件参数直接运行即可进入；ugrep 命令本身不带 TUI，适合脚本调用。资料把 TUI 列为 ugrep 的主要卖点之一，但页面只给出入口和截图，没有详细按键说明，具体键位建议在程序内按帮助键查看。

进入与基本用途

• 在终端直接运行 ug，进入全屏交互界面，输入模式后即时显示匹配结果，可边输入边浏览。
• 适合“先找找看”的探索式搜索：不确定文件在哪、想快速翻看匹配上下文时，比反复敲 grep 命令更顺手。
• 需要固定、可复现的搜索时，改用 ugrep 命令，它不读取 .ugrep 配置、不设默认选项，行为更可预测。

配置与联动

• ug 会读取工作目录或主目录下的 .ugrep 配置文件，把常用选项（如忽略目录、颜色、默认文件类型过滤）预先固化，TUI 里就按这套偏好搜索。
• 用 ug --save-config OPTIONS 可以把当前配置和指定选项保存成新的 .ugrep 文件，把调好的习惯带到 TUI 中。
• 页面列出的 TUI 相关能力还包括 Google 式逻辑模式搜索、模糊搜索、直接搜 zip/7z/tar 等归档与 gz/xz/zstd 等压缩文件、搜二进制并十六进制查看，以及 PDF、docx 等文档（ug+ 命令覆盖 PDF、电子书、图片元数据）。

选择条件

• 交互浏览、临时排查：用 ug。
• 写进脚本、批量管道处理：用 ugrep。
• 要搜文档和电子书：用 ug+。

需要更细的按键和界面操作，可在 TUI 内查看帮助，或对照官网 Commands、Options 两节；同类的交互式搜索工具还有 ripgrep 生态的配套前端，但 ugrep 的 TUI 是内置的，无需额外安装。

ugrep如何搜索zip、tar等压缩包以及PDF文档中的内容?

ugrep 可以直接在压缩包（zip、7z、tar、pax、cpio、tarball）和 gz、Z、bz、bz2、lzma、xz、lz4、zstd、brotli 等压缩文件中搜索，无需先解压；PDF、doc、docx 等文档则由 ug+、ugrep+ 命令处理。资料中没有给出具体选项名，建议以 ugrep --help 或官网手册确认当前版本的开关。

压缩包与压缩文件

• 用 ugrep 或 ug 直接对压缩包路径执行模式搜索，它会进入包内逐项匹配，并支持嵌套压缩包（包中包）。
• 适合的场景：日志归档、发布包、备份目录里查某个字符串或正则，不必先 unzip/tar -x 再搜。
• 注意：二进制内容默认按二进制处理，若要看匹配处的十六进制内容，用 ugrep 的 hexdump 输出能力。

PDF 与文档

• 用 ug+（或 ugrep+）替代 ug/ugrep，它额外搜索 PDF、doc/docx 等文档、电子书以及图片元数据。
• 适合的场景：资料库里找某句话出自哪份 PDF、批量合同或论文中检索关键词。
• 选择条件：只搜纯文本和代码用 ugrep/ug；要覆盖 PDF、Office 文档就用 ug+。

组合用法

• 压缩包内若是文档，可把归档搜索与 ug+ 结合，一次覆盖“压缩包 + 文档”两层。
• 常用配套：-r 递归目录、-l 只列匹配文件名、-I 忽略二进制、--include/--exclude 按 glob 限定文件类型（官网有 Globs 与 File types 章节可查写法）。
• 需要反复使用同一组选项时，ug --save-config OPTIONS 会把偏好写入工作目录的 .ugrep，之后 ug 自动套用；ugrep 本身不读配置文件，适合脚本。

与其它 grep 类工具的侧重点

• 相比 GNU grep：ugrep 的差异在于内置归档/压缩文件与 PDF 文档搜索、TUI 交互界面、JSON/XML/CSV 格式化输出。
• 相比 ripgrep：ripgrep 强在代码库递归搜索的速度与默认忽略规则；ugrep 的卖点是压缩包、文档、二进制与多格式输出的覆盖面，官网也提供与同类工具的基准对比。
• 相比 ack 与 The Silver Searcher：后两者面向源码目录的简洁检索，不主打归档与 PDF 内容。

下一步：先运行 ugrep --help 查看本版本的归档相关选项，再用 ug+ 关键词 某文件.pdf 验证文档搜索是否可用。

ugrep的模糊搜索和逻辑模式匹配具体怎么用?

ugrep 的模糊搜索和逻辑模式匹配都通过命令行选项控制：模糊搜索用 -Z（或 --fuzzy）开启，逻辑模式匹配用 --and、--not、-%% 等组合多个模式。两者可以叠加使用。

模糊搜索怎么用

• 基本形式：ug -Z "pattern"，允许匹配与模式有少量差异的文本（拼写错误、字符增删换位等）。
• 调节容差：用 -Z1、-Z2 等数字控制允许的编辑距离，数字越大越宽松。
• 适用场景：在拼写不确定的日志、代码标识符、文档里找近似词，例如 ug -Z2 "recieve" 能同时命中 receive。
• 注意：模糊搜索会明显增加匹配量和耗时，建议配合目录、文件类型（-t）或 glob 缩小范围。

逻辑模式匹配怎么用

ugrep 把多个模式按布尔逻辑组合，而不是简单“任一命中”：

• 每个模式前加 -e，避免以 - 开头的模式被当成选项。
• 逻辑组合默认作用于同一行；开启多行匹配后（ugrep 支持无需额外选项的多行模式），可跨行判断。
• 适用场景：筛日志时“含 ERROR 且含 timeout 但不含 retry”，或在代码里找“调用了某函数且传了某参数”的行。

选择建议

• 只想找近似拼写、容忍输入错误：用 -Z，从小容差开始试。
• 需要精确布尔条件过滤噪音：用 --and/--not，比管道接多次 grep 更省事、更快。
• 两者结合，例如 ug -Z1 -e "config" --and --not -e "test"，可在近似匹配基础上再做逻辑排除。

具体选项细节和更多组合示例可查阅官网手册的 Options 与 Regex 章节：ugrep。