最省事用os.WriteFile写死字符串;动态拼接必须用fmt.Fprintf配*os.File;写结构体推荐json.MarshalIndent+os.WriteFile;高频写用WriteString或Write;并发需加锁或bufio.Writer。

直接用 os.WriteFile 写死字符串或字节切片最省事;但要动态拼接、带变量、控制格式,必须用 fmt.Fprintf 配合打开的 *os.File —— 这是唯一正解,别传路径字符串进去。
fmt.Fprintf 必须传 *os.File,不能传文件路径
常见错误是把字符串路径直接塞给 fmt.Fprintf,比如 fmt.Fprintf("log.txt", "msg=%s", s),报错 cannot use "log.txt" (type string) as type io.Writer。因为 fmt.Fprintf 第一个参数必须是实现了 io.Writer 接口的对象,而路径只是字符串。
- 先调
os.Create或os.OpenFile拿到*os.File -
os.Create("out.txt")等价于os.OpenFile("out.txt", os.O_CREATE|os.O_TRUNC|os.O_WRONLY, 0644),会清空原文件 - 追加写要用
os.O_APPEND | os.O_WRONLY组合,单用os.O_APPEND在某些文件系统上不生效 - 务必
defer file.Close(),否则句柄泄漏,跑几次就卡在too many open files
写结构体推荐 json.MarshalIndent + os.WriteFile
如果目标是把结构体转成可读 JSON 写入文件,别用 fmt.Fprintf 拼接 —— 容易漏引号、错转义、破坏语法。走标准序列化路径更稳。
- 结构体字段必须首字母大写(导出),且建议加
json:"name"tag,否则键名是"Name"而非"name" - 空值控制加
omitempty:例如Email string `json:"email,omitempty"` - 写入前用
os.MkdirAll(filepath.Dir(path), 0755)确保父目录存在,os.WriteFile不自动建目录 - 缩进用
json.MarshalIndent(v, "", " "),不是先json.Marshal再手动加空格
Fprintf vs WriteString vs Write:性能和语义别混用
高频写日志或固定文本时,fmt.Fprintf 是最重的选项 —— 它要解析格式串、反射取值、分配临时字符串。能绕开就绕开。
立即学习“go语言免费学习笔记(深入)”;
- 纯写已拼好的字符串,用
file.WriteString("status=ok\n"),比Fprintf快 2–5 倍 - 拼接少量内容+时间戳等动态值,用
buf := []byte("ts="); buf = append(buf, time.Now().Format(...)...); file.Write(buf),零分配 -
Fprintf适合低频、需精确格式控制(如%08x)、调试输出等场景 - 三者都不自动换行,
\n得自己加
并发写文件要小心 Fprintf 的非原子性
*os.File 内核写是线程安全的,但 fmt.Fprintf 的整个流程(格式化 → 写缓冲 → 刷盘)不是原子操作。多个 goroutine 同时调它,可能交叉输出。
- 简单方案:用
sync.Mutex包一层写逻辑 - 高效方案:改用
bufio.Writer,批量写+显式Flush,再配合锁,减少系统调用次数 - 极端高频场景(如日志),考虑用 channel + 单独 writer goroutine 汇总写入
- 别依赖
os.O_APPEND当并发保护 —— 它只保证每次write()原子追加,不防Fprintf中间被插队
最容易被忽略的是目录预建和错误分离:写 JSON 时 json.MarshalIndent 失败往往是因为字段含 func 或未导出字段,而 os.WriteFile 失败更常见于磁盘满、权限错、NFS 断连 —— 两个错误必须分开检查、分别处理。


















