ioutil.WriteFile用于一次性写入文件，参数包括路径、字节切片和权限，支持字符串、JSON等数据类型转换后写入，但会覆盖原文件，不适用于大文件或追加场景，Go 1.16起推荐使用os.WriteFile替代。
在Go语言中，ioutil.WriteFile 是一种快速、简洁的文件写入方式，适用于将数据一次性写入文件的场景。虽然从Go 1.16开始，ioutil.WriteFile 被归入废弃状态（建议使用 os.WriteFile），但其用法依然广泛存在于现有项目中。本文以实践角度说明如何正确使用该函数进行文件写入。
函数签名与参数说明
ioutil.WriteFile 的函数原型如下：
func WriteFile(filename string, data []byte, perm fs.FileMode) error三个参数分别表示：
- filename：目标文件路径，字符串类型
- data：要写入的数据，必须是字节切片（[]byte）
- perm：文件权限，如 0644、0755 等
该函数会自动创建文件（如果不存在），若文件已存在则覆盖原内容。
立即学习“go语言免费学习笔记（深入）”；
基本写入示例
以下是一个将字符串写入文本文件的简单例子：
package mainimport (
"io/ioutil"
)
func main() {
content := "Hello, Golang!"
err := ioutil.WriteFile("output.txt", []byte(content), 0644)
if err != nil {
panic(err)
}
}
执行后会在当前目录生成 output.txt，内容为 "Hello, Golang!"，权限设置为 0644（即所有者可读写，其他用户只读）。
处理不同数据类型
由于 WriteFile 接收的是字节切片，因此需要将其他类型转换为 []byte：
- 字符串 → []byte(str)
- 结构体 → 先用 json.Marshal 转为 JSON 字符串再转字节
- 整数等基础类型 → 使用 strconv 或 fmt.Sprint 转为字符串再转字节
例如写入 JSON 数据：
type User struct {Name string `json:"name"`
Age int `json:"age"`
}
user := User{Name: "Alice", Age: 25}
data, _ := json.Marshal(user)
ioutil.WriteFile("user.json", data, 0644)
注意事项与替代方案
尽管 ioutil.WriteFile 使用方便，但需注意以下几点：
- 它是一次性写入，不适合大文件或需要追加写入的场景
- 文件会被完全覆盖，无法追加内容
- 从 Go 1.16 起推荐使用 os.WriteFile 替代
使用 os.WriteFile 的方式几乎一致：
import "os"os.WriteFile("output.txt", []byte("data"), 0644)
两者行为相同，但 os 包是标准维护位置。
基本上就这些。对于简单配置、日志或临时文件写入，WriteFile 非常实用，理解其机制有助于写出更可靠的文件操作代码。
