推荐使用os.WriteFile写入整个字节切片,简洁安全;需追加或分块写入时用os.OpenFile+Write;ioutil.WriteFile已弃用,须迁移至os包;字符串须转[]byte或用WriteString。

在 Go 语言中写入文件数据,最常用且推荐的方式是使用 os.WriteFile(Go 1.16+)或 ioutil.WriteFile(已弃用,但旧项目仍可见),而底层的 os.File.Write 更适合流式、分块或需要精细控制的场景。三者适用场景不同,不能简单说“哪个更好”,关键看需求。
直接写入整个字节切片:用 os.WriteFile 最简洁
os.WriteFile 是当前标准写法,一行完成创建/覆盖写入,自动处理文件打开、写入、关闭和错误检查:
- 函数签名:
func WriteFile(filename string, data []byte, perm fs.FileMode) error - 会自动以
O_WRONLY | O_CREATE | O_TRUNC模式打开文件(即覆盖写入) - 权限参数需显式指定,如
0644;Windows 上权限会被忽略
示例:
package mainimport (
"os"
)
func main() {
err := os.WriteFile("output.txt", []byte("Hello, Go!"), 0644)
if err != nil {
panic(err)
}
}
兼容旧版本或需追加写入:用 os.OpenFile + Write 配合控制
当需要追加内容、写入大文件、或分多次写入时,应使用 os.OpenFile 获取 *os.File,再调用其 Write 方法:
立即学习“go语言免费学习笔记(深入)”;
-
os.OpenFile支持自定义标志位,如os.O_APPEND追加、os.O_CREATE创建、os.O_WRONLY只写 -
file.Write([]byte)返回实际写入字节数和错误;需检查是否写满(尤其在部分写入场景) - 务必用
defer file.Close()确保资源释放
示例(追加写入):
f, err := os.OpenFile("log.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)if err != nil {
panic(err)
}
defer f.Close()
n, err := f.Write([]byte("[INFO] service started\n"))
if err != nil {
panic(err)
}
println("wrote", n, "bytes")
避免踩坑:ioutil.WriteFile 已废弃,别再新项目中使用
ioutil.WriteFile 在 Go 1.16 中被移入 os 包,原 ioutil 版本已弃用。继续使用会导致:
- 构建警告:
"ioutil" is deprecated: As of Go 1.16, the same functionality is available in "os" - 未来版本可能彻底移除,影响可维护性
- 行为与
os.WriteFile完全一致,无额外优势
迁移只需两步:
– 把 import "io/ioutil" 改为 import "os"
– 把 ioutil.WriteFile(...) 替换为 os.WriteFile(...)
进阶提示:写入字符串?记得转成 []byte
Go 中文件操作面向字节,没有直接写字符串的 API。常见误区是误传字符串:
- ❌ 错误:
f.Write("hello")—— 类型不匹配,编译失败 - ✅ 正确:
f.Write([]byte("hello"))或f.WriteString("hello")(*os.File也支持该方法) - 若内容含中文等 UTF-8 字符,
[]byte(str)天然支持,无需额外编码转换










