使用os.OpenFile可精确控制文件写入与追加,结合os.O_APPEND实现日志追加;ioutil.WriteFile适合一次性覆盖写入;频繁写入推荐bufio.Writer提升性能。

在Go语言中,文件写入与追加是日常开发中常见的操作,比如日志记录、数据导出等场景。掌握正确的文件操作方式,不仅能提升程序稳定性,还能避免资源泄漏或数据丢失。
使用 os.OpenFile 进行精确控制
Go的 os.OpenFile 函数提供了对文件打开模式的细粒度控制,适合用于写入和追加操作。
函数原型为:
func OpenFile(name string, flag int, perm FileMode) (*File, error)其中 flag 参数决定操作类型:
立即学习“go语言免费学习笔记(深入)”;
- os.O_WRONLY:只写模式
- os.O_CREATE:文件不存在时创建
- os.O_TRUNC:写入前清空文件内容
- os.O_APPEND:追加模式,写入内容放在文件末尾
例如,追加内容到文件:
file, err := os.OpenFile("log.txt", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)if err != nil {
log.Fatal(err)
}
defer file.Close()
_, err = file.WriteString("新的日志条目\n")
if err != nil {
log.Fatal(err)
}
使用 ioutil.WriteFile 简化一次性写入
对于需要覆盖写入整个文件的场景,ioutil.WriteFile 是最简洁的方式。
它会自动创建或覆盖指定文件,适合写配置、临时数据等。
data := []byte("这是要写入的内容\n")err := ioutil.WriteFile("output.txt", data, 0644)
if err != nil {
log.Fatal(err)
}
注意:此方法每次都会清空原文件内容,不适用于追加。
使用 bufio 提升写入效率
当需要频繁写入多行内容时,建议使用 bufio.Writer 缓冲写入,减少系统调用次数,提高性能。
file, err := os.OpenFile("data.txt", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)if err != nil {
log.Fatal(err)
}
defer file.Close()
writer := bufio.NewWriter(file)
for i := 0; i _, err := writer.WriteString(fmt.Sprintf("第%d行\n", i))
if err != nil {
log.Fatal(err)
}
}
// 别忘了刷新缓冲区
err = writer.Flush()
if err != nil {
log.Fatal(err)
}
Flush 是关键步骤,确保所有缓冲内容真正写入磁盘。
注意事项与最佳实践
进行文件操作时,有几个关键点需要注意:
- 始终使用 defer file.Close() 防止文件句柄泄露
- 设置合理的文件权限,通常为 0644(用户可读写,组和其他用户只读)
- 追加模式下避免使用 O_TRUNC
- 大文件写入优先使用 bufio 或分块写入
- 考虑并发写入时的文件锁问题(可借助 flock 等机制)
基本上就这些。Go 的文件操作设计简洁,只要理解 open flag 的组合逻辑,就能灵活应对各种写入需求。










