同时支持 gui & cli 的 parquet 文件查看工具，高性能小清新！

Parquet 文件怎么看？告别 Python 临时脚本，试试这款轻量级查看工具 ParqForge

手里拿到一个 .parquet 文件，想快速确认里面有什么：字段是什么、多少行、压缩方式、前几条数据长什么样......却不得不打开 Notebook，临时写一段 pandas / pyarrow 代码？

如果这正是你的日常，ParqForge 或许能帮你省掉这些重复动作。

Parquet 已经是数据湖、数仓和离线分析中的常用格式，但"随手看一眼文件"并不轻松：

ParqForge 是一个本地运行、只读的 Parquet 查看与探索工具。它的目标很明确：让你不用写代码，也能快速看懂一个 Parquet 文件或分区数据集。

ParqForge 提供命令行工具 pqx，并为 Windows 提供桌面查看器，适合开发、排障、数据验收和临时分析时快速使用。

需求	ParqForge 的做法
想确认字段和类型	`pqx inspect` 查看 schema、可空性、压缩、编码、行组与行数
想快速看数据	`pqx head`、`pqx tail`、`pqx cat` 预览首尾记录
想查看分区数据集	`pqx tree` 以目录树浏览 Parquet 文件、大小和创建时间
不想写脚本	Windows 可直接使用桌面查看器打开文件或目录
担心误操作数据	工具以只读方式工作，不修改 Parquet 原始数据

它支持两种常见输入：

如果使用 Windows，可以通过 WinGet 安装桌面版：

powershell 复制代码

winget install humbinal.ParqForge

也可以前往 Releases 下载页下载 MSI 安装包或便携版。MSI 会安装桌面程序 ParqForge.exe 和命令行工具 pqx.exe，并将 pqx 加入系统 PATH；安装后还可直接通过文件关联打开 .parquet 文件。

bash 复制代码

pqx inspect data.parquet

你可以看到列名、数据类型、是否允许为空、压缩方式、编码方式，以及总行数、Row Group 数量等关键信息。排查"字段不对""数据量不对""压缩格式不符合预期"时很实用。

bash 复制代码

# 查看前 20 行
pqx head data.parquet -n 20

# 查看后 20 行
pqx tail data.parquet -n 20

终端表格带有从 1 开始的行号；列较多时会自动分块展示，长文本默认截断，避免输出被一整列内容淹没。

bash 复制代码

pqx cat data.parquet -n 5

当文件较大时，cat 会展示前后各 5 行，中间用省略行隔开；需要完整输出时可以加上 --all：

bash 复制代码

pqx cat data.parquet --all

bash 复制代码

pqx tree dataset/

对于按日期、地区、业务线分区的数据集，这个命令会把目录和其中的 Parquet 文件以树形方式列出来，同时显示文件大小和创建时间。你不必再在资源管理器和脚本之间来回切换。

同样的命令也可以直接作用于分区目录：

bash 复制代码

pqx inspect dataset/date=2026-07-19/region=us/
pqx head dataset/date=2026-07-19/region=us/ -n 10

其他平台请从github发布页面下载。

CLI 可通过 cargo-binstall 安装：

bash 复制代码

cargo binstall parqforge-cli

或者从 Releases 下载对应平台的压缩包，将 pqx 加入 PATH 即可。

所有命令都可通过 --help 查看帮助：

bash 复制代码

pqx --help
pqx inspect --help

ParqForge 不想替代 Spark、DuckDB 或 Python 数据栈；它更像你处理 Parquet 时应该随手可得的一把"小刀"------打开快、信息够、不会改数据。当你只想回答"这个 Parquet 里到底有什么"时，不必再为此启动一整套分析环境。

如果你也经常和 Parquet 文件打交道，欢迎试用并反馈：

如果觉得项目对你有用，欢迎动动小手给个 star ！