如何使用Golang ioutil读写文件_快速操作文件内容

Go 1.16起ioutil被弃用,应改用os.ReadFile/os.WriteFile替代读写操作,os.MkdirTemp替代TempDir,io.NopCloser替代NopCloser,并移除io/ioutil导入。

Go 1.16 起,ioutil 已被弃用,其全部功能已迁移至 ioos 包中。直接使用 ioutil.ReadFileioutil.WriteFile 会触发编译警告,也不符合当前最佳实践。

读取文件内容(替代 ioutil.ReadFile)

推荐使用 os.ReadFile —— 它是 ioutil.ReadFile 的直接继承者,用法完全一致,但更轻量、无额外依赖。

  • 自动处理打开、读取、关闭全过程,无需手动调用 f.Close()
  • 返回字节切片([]byte),如需字符串可直接转:string(data)
  • 错误需显式检查,避免忽略 I/O 失败(如文件不存在、权限不足)

示例:

data, err := os.ReadFile("config.json")
if err != nil {
    log.Fatal("读取失败:", err)
}
content := string(data) // 转为字符串

写入文件内容(替代 ioutil.WriteFile)

使用 os.WriteFile,它等价于旧版 ioutil.WriteFile,支持自动创建文件、覆盖写入和权限设置。

  • 第三个参数是文件权限(如 0644),Windows 上会被忽略,但建议始终传入以保证跨平台一致性
  • 若目标路径含多层目录(如 logs/app.log),需提前用 os.MkdirAll 创建父目录
  • 不支持追加写入;如需追加,请改用 os.OpenFile 配合 os.O_APPEND | os.O_WRONLY | os.O_CREATE

示例:

err := os.WriteFile("output.txt", []byte("Hello, Golang!"), 0644)
if err != nil {
    log.Fatal("写入失败:", err)
}

需要控制读写细节?用 os.File 手动操作

当要逐行读、流式处理大文件、或精确控制缓冲/偏移时,应绕过便捷函数,直接使用 *os.File

  • 读:用 bufio.Scanner 逐行读取,内存友好
  • 写:用 bufio.Writer 缓冲写入,减少系统调用次数
  • 务必在操作完成后调用 f.Close(),建议用 defer 保证执行

示例(逐行读取):

f, err := os.Open("input.txt")
if err != nil {
    log.Fatal(err)
}
defer f.Close()

scanner := bufio.NewScanner(f)
for scanner.Scan() {
    line := scanner.Text()
    fmt.Println(line)
}
if err := scanner.Err(); err != nil {
    log.Fatal("扫描出错:", err)
}

小贴士:别再 import "io/ioutil"

现有代码中若还引用了 "io/ioutil",请立即替换:

  • io/ioutil.ReadFileos.ReadFile
  • io/ioutil.WriteFileos.WriteFile
  • io/ioutil.TempDiros.MkdirTemp
  • io/ioutil.NopCloserio.NopCloser(注意包路径变为 io

同时删除 import "io/ioutil",避免潜在的兼容性问题和静态分析告警。