N14 / 40 · Binary Layout

GGUF 模型格式指南
拆开一个文件名

粘贴 GGUF 文件名,拆出模型、参数量、Q4_K_M 量化等级 与分片编号,估算下载体积并生成可用命令。

  • 16 种量化标签
  • 分片完整性校验
  • 文件结构分层图
  • 批量解析与导出
Filename parser / 文件名解析台

GGUF 文件结构

按字节顺序排列的分区示意,宽度仅作结构说明,不代表真实占比。

GGUF v3 的 tensor_count 与 metadata_kv_count 为 uint64;对齐填充随文件配置的 alignment 而定,常见为 32 或 64 字节。

量化标签色阶表

平均位宽为近似值,用于比较体积量级;点击一行可载入解析台示例。

批量解析 · 分片校验 · 下载命令

每行一个文件名;同系列分片会合并检查序号是否连续、总数是否一致。

批量文件名

0 行

下载命令与转义

本机生成,不发起请求

常见问题

围绕文件名、量化等级、文件结构与体积估算整理。

GGUF 文件名怎么看?

常见格式是「模型名-参数量-量化等级-分片编号.gguf」,例如 qwen2.5-7b-instruct-q4_k_m.gguf,其中 7b 是参数量、Q4_K_M 是量化等级。大文件会拆成 -00001-of-00003 这样的分片。把文件名粘进本页解析框,会拆出模型、参数量、量化、分片与估算体积;识别不出的字段会明确标注,不猜测。

Q4_K_M 怎么选?和 Q8_0 差多少?

量化等级用平均位宽(bpw)近似表示每个权重占多少位:Q8_0 约 8.5 bpw,Q4_K_M 约 4.8 bpw,体积接近减半,但精度损失更大。显存够就选高位宽,显存紧张再降到 Q4/Q3;本页色阶表列出常见标签的近似 bpw 与用途提示,实际大小以文件为准。

GGUF 文件结构是什么?

GGUF 是 llama.cpp 生态的单文件格式:开头 4 字节 magic「GGUF」,随后 version、tensor_count、metadata_kv_count(v3 为 uint64),接着是元数据键值对与张量信息表,按对齐要求填充后才是张量数据。元数据里带模型架构、上下文长度、分词器与量化信息,所以一个文件就能跑起来。

GGUF 显存和体积怎么估算?

本页按「参数量 × 平均位宽 ÷ 8 × 1.04」估算下载体积(1.04 含元数据与对齐开销),运行内存再加上下文相关的 KV 缓存与运行时预留。这是理论估算,不含框架差异、显存碎片与 KV cache 量化;部署前请以文件实际大小与 nvidia-smi 实测为准。

GGUF 与 pt 格式区别在哪里?

GGUF 面向 llama.cpp 这类本地推理运行时,把权重、分词器与元数据打包成单文件,并按量化类型组织;PyTorch 的 .pt / .safetensors 主要用于训练与通用推理框架,通常按张量保存且不含运行时元数据。两者不能互换,需要按所用运行时选择对应文件;下载前请确认仓库里标注的格式。

👣 做完这一步,顺便看看
🧰 乱码修复 / 文本编码转换 在线乱码修复工具:上传乱码文本文件或粘贴乱码字符串,用 UT… → 💻 假装工作模拟器 老板走近工位的一瞬间,点一下就能从摸鱼切回正经工作界面。代码… → 🧰 IP / 子网掩码计算器 在线子网计算器:输入 IP 地址与掩码(CIDR 前缀或点分… → ⏰ 下班倒计时 打工人专属下班计算器:实时倒计时距离下班还有多久、进度环显示… →
全部工具 →