在Golang的标准库中，io/ioutil包提供了便捷的文件操作接口，其中写入文件的功能被很多开发者广泛使用，能够快速实现将内容写入本地文件的需求，不需要手动处理过多的文件打开关闭逻辑。
io/ioutil写入文件的核心方法
io/ioutil包中用于写入文件的核心函数是ioutil.WriteFile，它的函数签名如下：
func WriteFile(filename string, data []byte, perm os.FileMode) error
参数说明：
- filename：要写入的文件路径，可以是绝对路径或者相对路径
- data：需要写入文件的字节数组内容
- perm：文件的权限模式，写入时会按照该权限创建文件（如果文件不存在的话）
- 返回值为error类型，写入成功时返回nil，失败时返回对应的错误信息
基础写入实践示例
下面是最简单的字符串写入文件的示例，将一段文本写入到当前目录的test.txt文件中：
package main
import (
"fmt"
"io/ioutil"
"os"
)
func main() {
// 要写入的文本内容
content := "这是使用ioutil写入的第一行内容n这是第二行内容"
// 将字符串转换为字节数组
data := []byte(content)
// 调用WriteFile写入文件，权限设置为0644，即所有者可读可写，其他用户只读
err := ioutil.WriteFile("test.txt", data, 0644)
if err != nil {
fmt.Printf("文件写入失败，错误信息：%vn", err)
return
}
fmt.Println("文件写入成功")
}
运行上述代码后，当前目录下会生成test.txt文件，内容就是定义的字符串内容，包含换行符也会正常生效。
写入其他类型数据
写入字节数组
如果本身已经有字节数组数据，可以直接传入ioutil.WriteFile，不需要额外转换：
package main
import (
"fmt"
"io/ioutil"
)
func main() {
// 直接定义字节数组
byteData := []byte{72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100} // 对应Hello World
err := ioutil.WriteFile("byte_test.txt", byteData, 0644)
if err != nil {
fmt.Printf("写入失败：%vn", err)
return
}
fmt.Println("字节数组写入成功")
}
写入JSON数据
实际开发中经常需要把结构体序列化为JSON后写入文件，结合encoding/json包即可实现：
package main
import (
"encoding/json"
"fmt"
"io/ioutil"
)
type User struct {
Name string `json:"name"`
Age int `json:"age"`
City string `json:"city"`
}
func main() {
user := User{
Name: "张三",
Age: 25,
City: "北京",
}
// 序列化结构体为JSON字节数组，第二个参数是缩进前缀，第三个是缩进字符，这里用空格缩进
jsonData, err := json.MarshalIndent(user, "", " ")
if err != nil {
fmt.Printf("JSON序列化失败：%vn", err)
return
}
// 写入JSON数据到文件
err = ioutil.WriteFile("user.json", jsonData, 0644)
if err != nil {
fmt.Printf("JSON文件写入失败：%vn", err)
return
}
fmt.Println("JSON文件写入成功")
}
注意事项与版本兼容
需要注意，在Go 1.16版本之后，io/ioutil包中的大部分函数都被迁移到了os包和io包中，ioutil.WriteFile被替换为os.WriteFile，两者的功能完全一致，参数和返回值都没有变化。如果是使用Go 1.16及以上版本开发，推荐使用os.WriteFile，避免使用已经被标记为废弃的ioutil包函数。替换方式非常简单，只需要修改导入包和函数调用即可：
package main
import (
"fmt"
"os" // 替换原来的io/ioutil
)
func main() {
content := "使用os.WriteFile写入的内容"
err := os.WriteFile("new_test.txt", []byte(content), 0644) // 直接调用os.WriteFile
if err != nil {
fmt.Printf("写入失败：%vn", err)
return
}
fmt.Println("使用os.WriteFile写入成功")
}
另外使用ioutil.WriteFile时，如果目标文件已经存在，函数会直接覆盖原有文件内容，不会追加写入，如果需要追加内容，需要结合os.OpenFile等其他文件操作方式实现，不适合直接使用该函数。
Golangio/ioutil文件写入ioutil_WriteFile修改时间：2026-06-09 15:06:30