go 的 bufio.writer 会把尚未写出的数据保存在自己的缓冲区中;结束写入前需要调用 flush() 并检查错误,否则这部分数据可能没有到达底层 writer。关闭 os.file 不会替你刷新外层缓冲。flush 也不等于物理落盘,文件同步要另行考虑 file.sync。

观察短文本在 Flush 前后是否到达底层 Writer
保存为 main.go,执行 go run main.go。这里用 bytes.Buffer 作为底层目标,短文本能够放入默认缓冲区,因此 WriteString 成功后目标长度仍是零;调用 Flush 后才变成六个字节。
package main
import (
"bufio"
"bytes"
"fmt"
)
func main() {
var target bytes.Buffer
writer := bufio.NewWriter(&target)
if _, err := writer.WriteString("hello\n"); err != nil {
panic(err)
}
fmt.Println("刷新前:", target.Len(), writer.Buffered()) // 0 6
if err := writer.Flush(); err != nil {
panic(err)
}
fmt.Println("刷新后:", target.Len(), writer.Buffered()) // 6 0
fmt.Printf("内容:%q\n", target.String())
}
大块写入可能直接交给底层 Writer,或在写入过程中触发刷新,不能认为每次 Write 都只修改内存。真正需要保证的是:程序结束或关闭目标前,把尚在缓冲区中的数据刷出,并检查返回错误。

按写入、Flush、关闭文件的顺序保存内容
用以下独立程序替换 main.go。临时文件由 main 创建并清理;writeAndClose 接管已打开文件的关闭责任。即使写入或 Flush 失败,也会关闭文件,并优先返回较早发生的错误。
package main
import (
"bufio"
"fmt"
"os"
)
func writeAndClose(file *os.File) (err error) {
defer func() {
closeErr := file.Close()
if err == nil {
err = closeErr
}
}()
writer := bufio.NewWriter(file)
if _, err = writer.WriteString("saved\n"); err != nil {
return err
}
return writer.Flush()
}
func main() {
file, err := os.CreateTemp("", "buffer-demo-*")
if err != nil {
panic(err)
}
name := file.Name()
defer os.Remove(name)
if err := writeAndClose(file); err != nil {
panic(err)
}
data, err := os.ReadFile(name)
if err != nil {
panic(err)
}
fmt.Printf("%q\n", data) // "saved\n"
}
defer file.Close 本身不会妨碍正确的 Flush 顺序,关键是正常返回前先调用并检查 Flush。需要请求文件同步时,可在 Flush 成功之后、Close 之前调用 file.Sync,并处理其错误;不能把 Flush 成功写成绝对的断电不丢失保证。
模拟底层写入失败,确认错误会在 Flush 时出现
下列独立程序提供一个始终报错的底层 Writer。短文本先进入缓冲,所以 WriteString 可以返回 nil;Flush 才会调用底层 Write 并得到模拟错误。实际文件可能因空间不足、设备错误等原因失败,应把失败传给调用方。
package main
import (
"bufio"
"errors"
"fmt"
)
type failingWriter struct{}
func (failingWriter) Write(data []byte) (int, error) {
return 0, errors.New("模拟写入失败")
}
func main() {
writer := bufio.NewWriter(failingWriter{})
_, writeErr := writer.WriteString("short")
fmt.Println("WriteString:", writeErr) // <nil>
flushErr := writer.Flush()
fmt.Println("Flush:", flushErr) // 模拟写入失败
if flushErr == nil {
panic("预期得到写入错误")
}
}</nil>
Writer 发生错误后会保留错误状态,不要假设再 Flush 一次就能重试成功。重建写入目标和重试时,还必须考虑是否已有部分字节写出,避免重复内容。










