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 -terse5.-bname：只看文件名，快速扫读
文件路径太长导致表格换行？用-bname只显示 basename：
sudo hcache --top 3 -bname输出立刻变得清爽，适合人眼快速扫描。
6.-nohdr：隐藏表头，节省两行空间
配合-terse或默认格式，去掉列名行，让脚本解析更简单：
sudo hcache --top 3 -terse -nohdr7.-histo：直方图直观展示缓存分布
用 Unicode 块字符绘制直方图，一眼看出各文件的缓存占用对比：
sudo hcache -histo file1 file2 file3适合在终端演示或快速对比多个文件的缓存占比。
8.-unicode：Unicode 风格表格边框
默认输出是 ASCII 的+---+风格，-unicode则换成更美观的圆角框线：
sudo hcache --top 5 -unicode9.-plain：纯文本输出，无任何边框
去掉所有表格框线，只保留数据行，配合日志系统或文本处理最合适：
sudo hcache --top 5 -plain10.-pps：JSON 模式下的逐页状态
配合-json使用，输出每个文件每一页（Page）的缓存状态，信息量巨大，适合深度分析：
sudo hcache -json -pps file.log⚠️ 提醒：
-pps输出可能非常庞大，慎用于大文件。
参数速查表
| 参数 | 作用 | 适用场景 |
|---|---|---|
--top X | 全局缓存文件排行 | 定位内存大户 |
-pid | 指定进程缓存分析 | 排查进程占用 |
-json | JSON 输出 | 脚本二次处理 |
-terse | 极简输出 | shell 脚本 |
-bname | 仅显示文件名 | 快速扫读 |
-nohdr | 隐藏表头 | 精简输出 |
-histo | 直方图 | 直观对比 |
-unicode | Unicode 边框 | 美化展示 |
-plain | 无边框输出 | 日志集成 |
-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.13️⃣ 再配合-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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
