推荐使用 github.com/arl/statsviz/bytesize 库实现字节格式化，它按 iec 标准支持 si（十进制）和 binary（二进制）两种模式，自动处理 0、负数及超大值，避免手写易错；若禁用第三方，则需手动实现并注意浮点精度与整数截断问题。
用 bytesize 库快速实现带单位的字节格式化
Go 标准库不提供文件大小格式化工具，直接手写容易漏掉边界情况（比如 0 字节、负数、单位进制混淆）。推荐用轻量第三方库 github.com/arl/statsviz/bytesize（注意不是同名但更重的 bytesize），它按 IEC 标准（1 KiB = 1024 字节）计算，输出符合系统习惯：
bytesize.ByteCountSI(1024) // "1.0 kB" bytesize.ByteCountBinary(1024) // "1.0 KiB"
关键点：
-
ByteCountSI用十进制（1000 进制），适合磁盘厂商标称值或 HTTP Content-Length 场景 -
ByteCountBinary用二进制（1024 进制），是 Linuxls -lh、du -h的默认行为，更贴近开发者直觉 - 自动处理 0、负数（返回 "0 B" 或 "-123 B"）、超大值（支持到 YiB）
不用外部依赖时的手动实现要点
如果项目禁止引入第三方，需自己写一个安全、可读、不溢出的版本。核心是避免浮点运算误差和整数除法截断：
func formatBytes(b int64) string {
const unit = 1024
if b == 0 {
return "0 B"
}
units := []string{"B", "KiB", "MiB", "GiB", "TiB", "PiB"}
u := 0
n := float64(b)
for n >= unit && u <p>常见坑：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill8096" title="Alibabacloud Sdk Client Initialization For Golang"><img
src="https://img.php.cn/upload/skill/000/000/081/179186233233253.jpg" alt="Alibabacloud Sdk Client Initialization For Golang" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill8096" title="Alibabacloud Sdk Client Initialization For Golang" class="overflowclass">Alibabacloud Sdk Client Initialization For Golang</a>
<p class="overflowclass">初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。</p>
</div>
<a rel="nofollow" href="/xiazai/skill8096" title="Alibabacloud Sdk Client Initialization For Golang" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
- 用
int而非int64接收字节数 → 4GB+ 文件会溢出 - 用
math.Log2计算单位指数 → 浮点误差导致 1024 变成 "1.0 KiB"，而 1023 变成 "1023 B"（应统一阈值） - 硬编码
1000进制 → 和du -h结果不一致，用户困惑
在 http.FileServer 中注入自定义格式化逻辑
Go 内置文件服务器（http.FileServer）返回的目录页里，文件大小是纯数字。想让它显示 "2.4 MiB"，必须替换其内部模板。方法是复制 net/http/fs.go 中的 dirList 函数，修改 fmt.Fprintf(w, "%17s", size) 这一行：
// 原始：fmt.Fprintf(w, "%17s", size) // 替换为： fmt.Fprintf(w, "%17s", formatBytes(size))
注意：
- 不能直接 patch
http.Dir，因为dirList是未导出函数 - 需完整复制
dirList实现（约 80 行），并确保 Go 版本兼容（不同版本模板字段可能微调） - 若只是 API 返回 JSON，直接在 struct tag 里用
json:"size,omitempty"+ 自定义MarshalJSON更干净
区分 os.Stat().Size() 和磁盘实际占用
os.Stat().Size() 返回的是文件逻辑大小（字节数），但磁盘占用常更大（因块对齐、稀疏文件、压缩等）。如果要显示真实占用，得调用系统命令或平台 API：
- Linux/macOS：用
stat -c "%b * 512" path（%b是分配块数，%B是块大小） - Windows：用
GetCompressedFileSize或解析fsutil file queryallocranges - 多数场景下，用户只关心逻辑大小，强行显示物理占用反而引发疑问（如“为什么 1KB 文件占了 4KB？”）
真正难的是单位一致性——同一页面里，HTTP 头用 SI（Content-Length: 1000000），终端命令用 Binary（ls -lh），监控指标又可能混用。选哪个取决于你的用户是谁、他们用什么工具对比。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
