小文件写入（≤几mb）应直接用os.writefile，它专为一次性覆盖写设计，内部优化为单次系统调用，比bufio.writer减少内存拷贝和系统调用次数，更轻量、错误更明确；仅追加或并发写时才需退回到os.openfile+bufio.writer。
小文件写入（≤几 MB）用 os.WriteFile 最省事、也最快，根本不需要自己上 bufio.Writer —— 额外加缓冲层反而多一次内存拷贝，纯属负优化。
什么时候该直接用 os.WriteFile
它专为“一次性覆盖写”设计，内部已做最优路径：打开文件 → 写入全量数据 → 关闭。对小文件来说，这个流程比手动管理 bufio.Writer + Flush + Close 更轻量、错误路径更清晰。
- 配置文件生成（如
config.json）、临时快照、CI 构建产物等典型场景 - 写入内容确定、无追加需求，且不关心中间状态是否落盘
- 单次写入量在几 KB 到 2–3 MB 之间——再大就该换流式方案了
为什么硬套 bufio.Writer 反而变慢
当你对一个 100KB 的 JSON 调用 w.WriteString 再 Flush，实际发生了：数据先拷贝进 bufio.Writer 的缓冲区（比如 4KB），然后缓冲区满或 Flush 时再拷贝到内核页缓存。两次 memcpy，而 os.WriteFile 是一次系统调用直达内核。
-
os.WriteFile底层调的是syscall.Write（Linux）或等效系统调用，无中间缓冲层 -
bufio.NewWriterSize(f, 4096)对小文件毫无收益，还引入Flush忘记就丢数据的风险 - 若误设大缓冲区（如 64KB），写入 100KB 数据会触发两次系统调用（64KB + 36KB），不如一次搞定
例外情况：小文件但需追加或并发写
如果必须追加（os.O_APPEND）或多个 goroutine 同时写同一小文件，就不能用 os.WriteFile，得退回到 bufio.Writer + 显式控制。
- 追加写：用
os.OpenFile(path, os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)，配bufio.NewWriterSize(f, 8*1024)（小缓冲够用） - 并发安全：别共享同一个
bufio.Writer，改用chan []byte+ 单消费者 goroutine 持有 writer - 务必每次
Flush()后检查错误：if err := w.Flush(); err != nil—— 小文件写失败往往卡在这一步，不是Write时
真正容易被忽略的是：小文件场景下，os.WriteFile 的错误类型很“诚实”，permission denied、no such file or directory、no space left on device 全在一次调用里暴露；而手写缓冲逻辑时，这些错误会被拖到 Flush() 才浮现，调试路径拉长。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
