pamburus/hl

这是什么？

核心功能

• 01将 JSON 和 logfmt 日志转换为带颜色的易读格式。
• 02支持按日志级别、时间范围和字段值过滤，并提供查询语法。
• 03可直接读取 gzip、bzip2、xz、zstd 压缩日志文件。
• 04通过索引对多个文件的日志按时间顺序排序。
• 05可同时跟随多个实时日志源，并按时间戳合并输出。
• 06支持自定义主题、时间格式和时区。

适用场景

• 在终端中调试时查看 JSON 格式的应用日志。
• 将多个 Kubernetes Pod 的日志合并为同一时间线实时查看。
• 在轮转压缩的日志归档中按错误或时间段检索信息。

快速上手

1. 1

   在 macOS 上使用 Homebrew 安装

   brew install hl
2. 2

   查看日志文件(默认使用 less 分页器)

   hl example.log

使用前须知

• !依赖外部分页器(如 less),没有内置分页器;README 中提到的 Windows 版 less 会破坏 ANSI 颜色。

标签

常见问题

hl 是什么？

一款命令行日志查看工具，可将 JSON 和 logfmt 日志转换为易读格式，并支持过滤、排序与实时跟踪。 hl 是一款用于阅读结构化日志的命令行工具。它可以解析 JSON 和 logfmt 格式的日志，以带颜色、可配置时间格式和时区的可读布局输出，并支持隐藏指定字段。输入既可以是单个或多个文件，也支持 gzip、bzip2、xz、zstd 等压缩格式。

hl 可以免费使用吗？用的什么许可证？

hl 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

hl 还在维护吗？

活跃维护中。hl 最近一次提交是在 2026年10月19日。

hl 适合用来做什么？

在终端中调试时查看 JSON 格式的应用日志。 将多个 Kubernetes Pod 的日志合并为同一时间线实时查看。 在轮转压缩的日志归档中按错误或时间段检索信息。

hl 怎么安装和运行？

在 macOS 上使用 Homebrew 安装: brew install hl 查看日志文件(默认使用 less 分页器): hl example.log

在哪里获取 hl？

源代码和安装说明在 GitHub 上：https://github.com/pamburus/hl