Fprintf写入文件前必须先用os.OpenFile或os.Create获取*os.File，不可直接传路径；它只向已实现io.Writer的句柄写入，需注意追加模式、关闭资源、并发安全及跨平台换行与权限问题。
用 Fprintf 写入文件前必须先打开文件并获取 *os.File
Fprintf 本身不负责打开或创建文件，它只向已存在的 io.Writer 写入格式化字符串。常见错误是直接传入文件路径字符串，比如 Fprintf("output.txt", "hello") —— 这会编译失败，因为第一个参数类型不对。
正确做法是先调用 os.OpenFile 或 os.Create 获取一个 *os.File，它实现了 io.Writer 接口：
file, err := os.Create("log.txt")
if err != nil {
log.Fatal(err)
}
defer file.Close()
fmt.Fprintf(file, "time: %v, count: %d\n", time.Now(), 42)
-
os.Create以O_WRONLY | O_CREATE | O_TRUNC模式打开，会清空已有内容 - 若需追加写入，改用
os.OpenFile("log.txt", os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644) - 记得
defer file.Close()，否则文件句柄泄漏，后续写入可能静默失败
Fprintf 和 WriteString / Write 的性能与适用场景差异
如果只是写纯字符串（无格式化），file.WriteString("hello") 比 Fprintf(file, "%s", "hello") 快得多 —— 前者零分配、无解析开销；后者要解析格式动词、处理参数反射、可能触发内存分配。
但只要涉及变量插值（尤其是多种类型混排），Fprintf 就不可替代：
立即学习“go语言免费学习笔记（深入）”；
// 合理：类型自动转换 + 对齐控制
fmt.Fprintf(file, "%-10s %8.2f %t\n", "cpu", 99.5, true)
// 不合理：硬拼接易出错，且无法复用格式
file.WriteString("cpu " + strconv.FormatFloat(99.5, 'f', 2, 64) + " " + strconv.FormatBool(true) + "\n")
- 高频小写入（如每毫秒一条日志）建议用
bufio.Writer包裹*os.File，再传给Fprintf，避免每次系统调用 - 写入后不立即刷盘，
file.Sync()才强制落盘；否则进程崩溃可能导致最后几 KB 丢失
写入失败时 Fprintf 返回的 err 往往不是你想的“磁盘满”
Fprintf 返回的错误通常是底层 Write 调用失败所致，但具体原因藏在 os.PathError 或 syscall.Errno 里。直接打印 err.Error() 可能只显示 "write: broken pipe" 或 "bad file descriptor"，让人误以为是文件问题。
真正该检查的是：file 是否已被关闭、是否被其他 goroutine 并发关闭、是否以只读模式打开却尝试写入。
- 典型陷阱：多个 goroutine 共享一个
*os.File且未加锁，Close()和Fprintf()竞态 → 随机报"use of closed network connection"类似错误 - 调试时可用
errors.Is(err, os.ErrClosed)判断是否因文件已关导致 - 生产环境建议封装写操作，统一处理重试/降级（如写失败时切到临时文件）
Windows 下换行符和文件权限容易被忽略
Go 的 Fprintf 在 Windows 上默认输出 \r\n，这通常没问题；但若文件用于跨平台解析（如 CSV 被 Linux 工具读），可能因多出 \r 导致字段错位。这不是 Fprintf 的问题，而是换行符语义差异。
更隐蔽的是权限问题：os.Create 在 Windows 上忽略 perm 参数（始终为 0666），但在 Linux/macOS 上若 umask 是 0022，则实际创建为 0644。若程序需要可执行脚本，得额外调用 os.Chmod。
- 跨平台写文本文件，推荐用
fmt.Fprintln替代手拼\n，它会适配平台换行 - 若需严格 Unix 权限（如 0600 私钥文件），Windows 用户得接受“权限无效”，Linux/macOS 用户则必须显式
os.Chmod(path, 0600) - 路径分隔符别硬写
"dir\file.txt"，用filepath.Join("dir", "file.txt")更安全
Fprintf 藏在深层函数里，错误返回又被忽略时。 
