Fprintf写文件必须传*os.File而非路径字符串，需先用os.OpenFile或os.Create获取文件句柄；高频写入优先用WriteString/Write避免格式化开销；并发写需加锁或用bufio.Writer；Windows换行和编码需手动处理。
Go 里用 Fprintf 写文件，必须传 *os.File，不能传路径字符串
很多人卡在第一步：直接把文件路径传给 Fprintf，结果报错 cannot use "xxx.txt" (type string) as type io.Writer。因为 Fprintf 第一个参数必须是实现了 io.Writer 接口的类型，比如 *os.File，而不是字符串路径。
正确流程是先用 os.OpenFile 或 os.Create 打开/创建文件，拿到 *os.File，再传给 Fprintf：
file, err := os.OpenFile("log.txt", os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
if err != nil {
log.Fatal(err)
}
defer file.Close()
fmt.Fprintf(file, "user_id=%d, time=%s\n", 123, time.Now().Format(time.RFC3339))
-
os.Create等价于os.OpenFile(..., os.O_CREATE|os.O_TRUNC|os.O_WRONLY)，会清空原文件 - 追加写用
os.O_APPEND，但注意它和os.O_WRONLY要一起用，单独用可能不生效（尤其在某些文件系统上） - 记得
defer file.Close()，否则文件句柄泄漏，多次运行后可能报too many open files
Fprintf 和 WriteString / Write 的性能与适用场景差异
Fprintf 是格式化写入，底层会分配临时字符串、做类型反射（对非基本类型）、再调用 Write；而 file.WriteString 或 file.Write([]byte(...)) 是纯字节写入，零分配（如果字符串常量或预分配）。
高频写日志、拼接简单字段时，后者快 2–5 倍，且更可控：
立即学习“go语言免费学习笔记（深入）”；
// 快，无格式化开销
file.WriteString("status=ok, code=200, ")
// 更快，避免字符串拼接（适合已拼好的 []byte）
buf := []byte("status=ok, code=200, ts=")
buf = append(buf, time.Now().Format(time.RFC3339)...)
file.Write(buf)
- 如果只是写固定字符串或已拼好的内容，别用
Fprintf，浪费 CPU 和 GC 压力 -
Fprintf适合调试输出、低频配置写入、需要格式控制（如%08x）的场景 - 注意：
WriteString不自动换行，Fprintf也不自动——换行符得自己加
多 goroutine 并发写同一个文件，Fprintf 不是线程安全的
*os.File 本身是并发安全的（内核层面有 write lock），但 Fprintf 的格式化过程不是原子的：格式化字符串 → 写入缓冲 → 刷盘，中间可能被其他 goroutine 插入写操作，导致日志错乱，比如：
// goroutine A fmt.Fprintf(file, "req_id=abc, method=GET") // goroutine B 同时执行 fmt.Fprintf(file, "req_id=xyz, method=POST") // 实际文件内容可能变成： // req_id=abcreq_id=xyz, method=POST, method=GET
- 解决方法不是加锁整个
Fprintf调用（太重），而是用bufio.Writer+ 单独 goroutine 串行刷盘 - 或者用带锁封装的 logger（如
log.SetOutput配合sync.Mutex包裹Write） - 更推荐：每个 goroutine 写自己的临时文件，后续用外部工具合并；或直接用成熟库如
zap、zerolog
Windows 下换行符和文件编码问题，Fprintf 本身不处理
Fprintf 只负责按 Go 字符串内容写入字节，不会自动转 \r\n，也不会做 UTF-8 → GBK 转换。Windows 记事本打开乱码，大概率是因为文件是 UTF-8 无 BOM，而记事本默认用本地编码（GBK）解析。
- 写文本文件时，换行统一用
\n（Go 标准做法），多数编辑器（VS Code、Notepad++）能正确识别 - 如果必须兼容老旧 Windows 记事本，手动补
\r\n：Fprintf(file, "line1\r\nline2\r\n") - 真正要改编码（如写 GBK），得用
golang.org/x/text/encoding包包装io.Writer，Fprintf无法直接支持
文件写入这事，表面是函数调用，背后牵扯打开模式、缓冲策略、并发模型、平台细节——漏掉任意一环，都可能在压测或跨平台时突然崩掉。
