hcache实战教程：10个必会命令参数玩转页缓存分析

hcache实战教程：10个必会命令参数玩转页缓存分析

【免费下载链接】hcacheshowing top X biggest cache files global项目地址: https://gitcode.com/gh_mirrors/hc/hcache

hcache 是一款开源 Linux 页缓存分析工具，能一键展示"哪些文件占用了最多内存缓存"。当你用free看到内存被吃掉却不知道元凶是谁时，hcache 就是那个帮你揪出缓存大文件的利器。本文是一份面向新手的 hcache 实战教程，逐一拆解 10 个必会的 hcache 命令参数，从全局排行到进程分析，帮你彻底玩转 Linux 页缓存分析。

什么是页缓存？为什么需要 hcache？

Linux 会把读过的磁盘文件暂存在内存中，这就是"页缓存"（Page Cache）。它让下次读取更快，但也常造成"内存明明很多，却显示已用 90%"的错觉。

传统排查方式很痛苦：

• free -h只能看到缓存总量，看不到具体是哪些文件
• pcstat可以查单文件或单进程，但结果不排序，全局视角缺失

hcache 正是在 pcstat 基础上增加了杀手锏功能--top，可以全局扫描所有进程打开的文件，按缓存大小倒序排列，直接告诉你"最大的缓存文件是谁"。其核心实现位于 main.go 与 pkg/utils/process.go，底层调用mincore(2)系统调用按 4K 页粒度统计。

快速安装 hcache

需要 Go 1.12+ 环境，编译命令如下：

git clone https://gitcode.com/gh_mirrors/hc/hcache cd hcache make build sudo cp hcache /usr/local/bin/

💡 注意：分析页缓存需要读取/proc与调用mincore，请务必用 sudo 运行 hcache，否则结果会不完整或报错。

10 个必会的 hcache 命令参数详解

1.--top X：一键查看全局缓存文件 Top 榜 🔥

这是 hcache 的灵魂参数，全局扫描后输出缓存占用最大的前 X 个文件：

sudo hcache --top 5

输出包含 6 列：Name（文件路径）、Size（文件大小）、Pages（总页数）、Cached Size（已缓存大小）、Cached Pages（已缓存页数）、Percent（缓存命中率），底部还有一行Sum汇总。命中率高达 70%+ 的文件就是你的内存大户！

2.-pid：追踪指定进程的缓存占用

怀疑某个进程吃内存？用-pid查看该进程打开的所有文件的缓存情况：

sudo hcache -pid 20630

它会解析/proc/<pid>/maps，列出该进程映射的全部文件及缓存状态，非常适合排查 Java、数据库等常驻进程。

3.-json：结构化输出，方便脚本二次处理

把结果输出为 JSON，无缝对接 jq、Python 等工具：

sudo hcache --top 10 -json | jq '.[].Name'

适合写监控脚本，定时采集缓存排行数据。

4.-terse：极简输出，机器可解析

以紧凑的制表符分隔格式输出，不带装饰性边框，是 shell 脚本的最佳搭档：

sudo hcache --top 3 -terse

5.-bname：只看文件名，快速扫读

文件路径太长导致表格换行？用-bname只显示 basename：

sudo hcache --top 3 -bname

输出立刻变得清爽，适合人眼快速扫描。

6.-nohdr：隐藏表头，节省两行空间

配合-terse或默认格式，去掉列名行，让脚本解析更简单：

sudo hcache --top 3 -terse -nohdr

7.-histo：直方图直观展示缓存分布

用 Unicode 块字符绘制直方图，一眼看出各文件的缓存占用对比：

sudo hcache -histo file1 file2 file3

适合在终端演示或快速对比多个文件的缓存占比。

8.-unicode：Unicode 风格表格边框

默认输出是 ASCII 的+---+风格，-unicode则换成更美观的圆角框线：

sudo hcache --top 5 -unicode

9.-plain：纯文本输出，无任何边框

去掉所有表格框线，只保留数据行，配合日志系统或文本处理最合适：

sudo hcache --top 5 -plain

10.-pps：JSON 模式下的逐页状态

配合-json使用，输出每个文件每一页（Page）的缓存状态，信息量巨大，适合深度分析：

sudo hcache -json -pps file.log

⚠️ 提醒：-pps输出可能非常庞大，慎用于大文件。

参数速查表

实战案例：30 秒揪出"内存杀手"

1️⃣ 先看全局排行：

sudo hcache --top 3

输出类似：

| Name | Size | Pages | Cached Size | Cached Pages | Percent | | /usr/lib/libLLVM.so.1 | 74.384M | 19043 | 48.057M | 12303 | 64.606 |

2️⃣ 拿到可疑文件路径后，用lsof反查是哪个进程在占用它：

lsof /usr/lib/libLLVM.so.1

3️⃣ 再配合-pid确认该进程的完整缓存清单，内存去向一目了然。

常见问题 FAQ

Q：-top和-pid能一起用吗？不能。两者是互斥的，同时使用会报错，先想清楚你要的是"全局"还是"单进程"视角。

Q：为什么必须 sudo？页缓存统计依赖读取所有进程的/proc映射和mincore调用，普通用户权限不足会导致结果缺失。

Q：Cached Size 是精确值吗？不完全是。缓存按页统计，Cached Size由文件大小与命中率估算而来，存在少量误差，但作为参考完全够用。

总结

hcache 用一条命令解决了"系统缓存被谁占了"的历史难题。记住--top全局排行、-pid进程分析、-json脚本化输出这三个黄金组合，再配合-bname、-histo等优化阅读体验的参数，你就能轻松玩转 Linux 页缓存分析，成为团队里最懂内存的人！🚀

【免费下载链接】hcacheshowing top X biggest cache files global项目地址: https://gitcode.com/gh_mirrors/hc/hcache