使用 bufio.writer 向文件写入数据后文件为空，根本原因是未调用 flush() 强制刷新缓冲区；此外，序列化可直接写入文件，无需中间 bytes.buffer 和额外 bufio.writer，既简化逻辑又避免此类陷阱。
使用 bufio.writer 向文件写入数据后文件为空，根本原因是未调用 flush() 强制刷新缓冲区；此外，序列化可直接写入文件，无需中间 bytes.buffer 和额外 bufio.writer，既简化逻辑又避免此类陷阱。
在 Go 中，bufio.Writer 为提升 I/O 性能，默认将写入操作暂存于内存缓冲区，仅当缓冲区满、调用 Flush() 或关闭底层 writer（如 file.Close()）时才真正落盘。但注意：defer file.Close() 发生在函数末尾，而 file 是 os.File，它本身不管理 bufio.Writer 的缓冲——你创建的 bufio.NewWriter(file) 是一个独立对象，其缓冲区不会因 file.Close() 自动刷新。因此，若未显式调用 writer.Flush()，缓冲区内数据将被丢弃，导致文件为空，即使 Write() 返回了正确的字节数（如 n > 1000）。
更优解是绕过不必要的缓冲层：*os.File 本身就实现了 io.Writer 接口，gob.Encoder 可直接接收 file 作为目标，实现零拷贝序列化：
func (order Order) Serialize(folder string) error {
// 安全创建目录（检查错误）
if err := os.MkdirAll(folder, 0755); err != nil {
return fmt.Errorf("failed to create directory %q: %w", folder, err)
}
// 安全拼接路径（自动处理斜杠）
filePath := filepath.Join(folder, order.Id)
// 直接创建并写入文件
file, err := os.Create(filePath)
if err != nil {
return fmt.Errorf("failed to create file %q: %w", filePath, err)
}
defer file.Close()
// gob 编码直接写入文件，无中间缓冲
if err := gob.NewEncoder(file).Encode(order); err != nil {
return fmt.Errorf("failed to encode order %q: %w", order.Id, err)
}
return nil
}
✅ 关键改进说明：
-
移除
bytes.Buffer和bufio.Writer：避免双重缓冲与手动Flush()遗漏风险； -
使用
filepath.Join：替代字符串拼接，兼容不同操作系统路径分隔符； -
返回
error而非panic：符合 Go 错误处理惯例，调用方可优雅处理失败； -
权限使用
0755：比0777更安全（禁用组/其他用户写权限）； -
错误包装（
%w）：保留原始错误链，便于调试与日志追踪。
⚠️ 若仍需 bufio.Writer（如批量小写入场景），务必在 defer file.Close() 前显式调用 writer.Flush()：
writer := bufio.NewWriter(file)
_, err := writer.Write(b.Bytes())
if err != nil { return err }
if err := writer.Flush(); err != nil { // 必须！
return err
}
总结：Go 的 I/O 设计强调显式性——缓冲即责任。优先选择直连 io.Writer 的简洁路径，既可靠又高效；若引入缓冲，务必配对 Flush()，这是避免“零字节文件”这类静默失败的核心原则。
