Golang ioutil读写文件实战教程

Go语言中ioutil包虽从1.16起废弃，但其ReadFile、WriteFile和TempFile方法仍用于读取文件、写入数据和创建临时文件；推荐新项目使用os.ReadFile、os.WriteFile替代以符合现代规范。

在Go语言中，ioutil 包曾是文件读取与写入的常用工具，尽管从Go 1.16起已被标记为废弃，推荐使用 os 和 io 包中的函数，但理解其用法仍有助于维护旧项目。以下是基于 ioutil 的文件操作实践。

读取整个文件内容

使用 ioutil.ReadFile 可以一次性读取文件全部内容，返回字节切片和错误信息。适合处理小文件。

示例：

content, err := ioutil.ReadFile("example.txt")
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(content))

该方法无需手动打开或关闭文件，内部已封装资源管理，简洁高效。

将数据写入文件

使用 ioutil.WriteFile 可将字节切片写入文件，支持指定权限模式。

示例：

data := []byte("Hello, Golang!")
err := ioutil.WriteFile("output.txt", data, 0644)
if err != nil {
    log.Fatal(err)
}

若文件已存在，会先清空内容再写入；权限参数 0644 表示文件所有者可读写，其他用户只读。

临时文件操作

ioutil 提供 ioutil.TempFile 快速创建临时文件，常用于缓存或中间数据存储。

示例：

tmpfile, err := ioutil.TempFile("", "tmp_*.txt")
if err != nil {
    log.Fatal(err)
}
defer os.Remove(tmpfile.Name()) // 使用后清理
defer tmpfile.Close()

content := []byte("temporary data")
tmpfile.Write(content)

第一个参数为空字符串时，使用系统默认临时目录（如 /tmp）。

迁移建议：使用 io 与 os 替代

从 Go 1.16 开始，应优先使用 os.ReadFile 和 os.WriteFile，它们功能与 ioutil 对应函数一致，且被正式推荐。

新写法示例：

content, err := os.ReadFile("example.txt")
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(content))

err = os.WriteFile("output.txt", []byte("Hello!"), 0644)
if err != nil {
    log.Fatal(err)
}

API 设计更清晰，归属更合理。

基本上就这些。虽然 ioutil 在旧代码中常见，但新项目应直接使用 os 中的读写函数，保持代码现代且符合官方指引。