17370845950

Go中处理文件写入错误需同时检查Write返回的n和err，因err==nil时n可能小于预期；推荐用io.WriteFull确保全量写入，或结合Sync/Flush保证落盘。

在 Go 中处理文件写入错误，核心是检查 Write 方法的返回值（n int 和 err error），而不是只关注 err 是否为 nil。因为即使 err == nil，n 也可能小于预期字节数，说明写入不完整——这在某些场景（如网络文件系统、磁盘满、信号中断）下真实存在。

Write 返回值的含义必须同时看 n 和 err

Write(p []byte) (n int, err error) 的语义是：最多写入 len(p) 字节，实际写入 n 字节，若发生错误则返回非 nil err。注意：

• n 可能小于 len(p)，且 err == nil：例如底层 buffer 满了、被信号中断（EINTR）、或某些特殊文件（如 /dev/full）；Go 标准库的 os.File.Write 在多数情况下会尝试写完全部，但不保证——尤其在非 POSIX 环境或封装的 Writer 上
• err != nil 时，n 的值是未定义的（文档明确说明），不可依赖
• 标准库中 io.WriteString、fmt.Fprint* 等也最终调用 Write，同样需检查其返回的 error

安全写入完整数据的推荐做法：用 io.WriteFull 或循环重试

若业务要求「要么全写入，要么失败」，不要手动拼接 Write 循环，而应使用标准库提供的健壮工具：

• io.WriteFull(w io.Writer, b []byte)：确保写入全部 b，返回 n == len(b) 或第一个遇到的 error；适合小到中等数据
• 对大文件或流式写入，用 io.Copy 或 w.Write(p) + 显式校验：例如写入后调用 file.Sync() 保证落盘，并检查 Sync() 的 error
• 自定义循环写入（不推荐初学者手写）示例逻辑：
  for len(p) > 0 {
    n, err := w.Write(p)
    if err != nil { return err }
    if n == 0 { return io.ErrUnexpectedEOF } // 防止死循环
    p = p[n:]
  }

常见易忽略的错误点

很多问题不是出在 Write，而是前置或后续步骤：

• 打开文件时没检查 error：如 f, err := os.OpenFile(...) 后直接用 f.Write，但 err != nil 会导致 panic 或静默失败
• 忘记关闭文件：用 defer f.Close()，否则可能因 fd 耗尽导致后续 Write 失败（报 too many open files）
• 写入后不 Sync/Flush：缓冲写入（如 bufio.Writer）需显式 Flush()；关键数据建议 file.Sync() 确保写入磁盘
• 误判临时错误：如 syscall.EAGAIN 或 syscall.EINTR 在某些 Writer 上可重试，但标准 os.File.Write 已内部处理，一般无需手动重试

一个简洁可靠的写文件函数示例

兼顾可读性与健壮性：

func writeFileAtomic(path string, data []byte) error {
  f, err := os.Create(path + ".tmp")
  if err != nil { return err }
  defer f.Close()

  if _, err = io.WriteFull(f, data); err != nil {
    return err
  }

  if err = f.Sync(); err != nil {
    return err
  }

  return os.Rename(path+".tmp", path)
}