Golang ioutil读写文件快速教程

Go 1.16起，官方已正式弃用io/ioutil包，所有文件读写功能（如ReadFile、WriteFile）、临时目录创建（TempDir）及NopCloser等均迁移至os和io标准包，本文手把手教你如何平滑升级：用轻量高效的os.ReadFile/os.WriteFile替代旧接口，掌握权限设置、父目录预创建和追加写入的正确姿势，并在需要精细控制时转向os.File配合bufio实现流式处理，最后提醒你彻底移除"io/ioutil"导入——这不仅是消除编译警告的必要操作，更是拥抱Go现代实践、提升代码健壮性与可维护性的关键一步。

Go 1.16 起，ioutil 已被弃用，其全部功能已迁移至 io 和 os 包中。直接使用 ioutil.ReadFile 或 ioutil.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.ReadFile → os.ReadFile
• io/ioutil.WriteFile → os.WriteFile
• io/ioutil.TempDir → os.MkdirTemp
• io/ioutil.NopCloser → io.NopCloser（注意包路径变为 io）

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

本篇关于《Golang ioutil读写文件快速教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！