Go Humanize 怎样把文件大小格式化为 IEC 单位

在 Go 项目里展示文件大小时，直接输出字节数通常不够友好。github.com/dustin/go-humanize 已经提供了面向 IEC 单位的 IBytes 和 IBytesN：前者按 1024 进位输出 KiB、MiB 等单位，后者还可以控制结果的总位数。本文只围绕这两个函数展开。

官方地址：https://pkg.go.dev/github.com/dustin/go-humanize

先把 IEC 和 SI 的单位边界分清

我第一次把文件大小放进管理列表时，最容易混淆的是 MB 和 MiB。IEC 二进制单位按 1024 进位：1 KiB = 1024 B，1 MiB = 1024 KiB；十进制 SI 单位则按 1000 进位。Humanize 的 IBytes 明确返回 IEC 风格结果，而 Bytes 对应的是 SI 风格结果。

这个区别不是换一个字母那么简单：同一个字节数使用两种函数，数值和后缀都可能不同。先在接口字段或产品说明里确定单位口径，再让函数负责格式化，后续的文案和排序才不会互相矛盾。

用 IBytes 完成默认的 IEC 文件大小展示

如果只想把文件字节数变成可读字符串，IBytes 是最直接的入口。它接收一个 uint64，返回带 IEC 后缀的字符串，适合文件列表、日志摘要和简单的状态字段：

package main

import (
    "fmt"

    "github.com/dustin/go-humanize"
)

func main() {
    // 文件大小通常来自 os.FileInfo.Size，单位是字节。
    size := uint64(82854982)

    // IBytes 使用 1024 进位，结果带 KiB、MiB 等 IEC 后缀。
    fmt.Println(humanize.IBytes(size))
}

例如官方文档用类似的字节值说明，IEC 结果会落在 MiB 范围内。这里应把返回值当作已经完成单位选择的展示文本，不要再用字符串替换把 MiB 改成 MB。如果业务要的是十进制磁盘厂商口径，应从一开始改用 humanize.Bytes，而不是修改输出后缀。

需要控制小数位时使用 IBytesN

默认格式适合快速阅读，但文件列表和卡片摘要经常需要统一长度。IBytesN 的第二个参数 n 表示结果允许使用的总位数，包括整数和小数部分。这样可以根据展示宽度选择一个固定策略：

package main

import (
    "fmt"

    "github.com/dustin/go-humanize"
)

func main() {
    // n 是总位数，不是只保留 n 位小数。
    size := uint64(82854982)

    // 总位数为 4 时，函数会在需要时保留小数部分。
    compact := humanize.IBytesN(size, 4)
    fmt.Println(compact)
}

官方文档给出的行为是：总位数足够时可以显示小数，若 n 不大于整数部分的位数，则省略小数。我的取舍通常是：表格列宽固定时选一个小的总位数，详情页或导出摘要需要更多信息时选更大的 n。不要把 n 当成“保留几位小数”，否则很容易把展示规则写错。

把单位选择和展示场景写成固定规则

还有两个实际边界值得提前写进代码约定。第一，os.FileInfo.Size 返回的是字节数，传入 Humanize 前不需要先除以 1024；重复换算会让结果小一个数量级。第二，来自 JSON、数据库或第三方接口的数值要先确认是否已经换算过，尤其不要把一个已经是 MiB 的字段再次当作字节数格式化。

• IBytes 和 IBytesN 都返回展示字符串，若后续还要排序，应保留原始的 uint64。
• 若产品文案要求“MB”但数据口径是 1024 进位，应先和产品确认命名，不要静默替换后缀。
• 超大文件仍应保持输入为 uint64，避免先转成有符号小整数造成截断。

常见问题

IBytes 和 Bytes 有什么区别？

IBytes 使用 IEC 的 1024 进位并输出 KiB、MiB 等后缀；Bytes 使用 SI 的 1000 进位并输出 kB、MB 等风格。选择取决于业务约定，不是哪个函数更“准确”。

IBytesN 的 n 是小数位数吗？

不是。n 是结果的总位数，包括整数部分和小数部分；当整数部分已经占满位数时，小数会被省略。

为什么不直接 fmt.Sprintf("%.2f MiB")？

手写格式只覆盖一个固定单位，遇到字节、KiB、GiB 的切换时还要自己处理进位、后缀和边界。Humanize 已经把这段单位选择封装起来，更适合通用文件大小展示。