Go 1.16 起 io/ioutil 被弃用,其功能迁移至 io、os 和 bufio 包。读取文件用 os.ReadFile 替代 ioutil.ReadFile;写入文件用 os.WriteFile 替代 ioutil.WriteFile;按行读取大文件推荐 os.Open 配合 bufio.Scanner;目录读取用 os.ReadDir,创建临时文件或目录分别用 os.CreateTemp 和 os.MkdirTemp,NopCloser 和 Discard 分别移至 io 包,迁移时只需调整导入包并替换函数名,用法保持一致。

Go 1.16 开始,io/ioutil 包已被弃用,其功能已迁移到 io、os 和 bufio 等标准包中。新项目应使用这些包里的函数替代,以保证代码的现代性和兼容性。
核心读取操作替代方案
以前常用 ioutil.ReadFile 一次性读取小文件,现在推荐使用 os.ReadFile:
- 旧方式:data, err := ioutil.ReadFile("filename.txt")
- 新方式:data, err := os.ReadFile("filename.txt")
对于需要流式处理的场景,os.Open 结合 defer file.Close() 依然是基础。配合 bufio.Scanner 可按行高效读取大文件:
file, err := os.Open("large.log")if err != nil { /* 处理错误 */ }
defer file.Close()
scanner := bufio.NewScanner(file)
for scanner.Scan() {
fmt.Println(scanner.Text())
}
核心写入操作替代方案
写文件操作也从 ioutil.WriteFile 迁移到了 os.WriteFile:
立即学习“go语言免费学习笔记(深入)”;
- 旧方式:err := ioutil.WriteFile("output.txt", data, 0644)
- 新方式:err := os.WriteFile("output.txt", data, 0644)
对于需要追加内容或多次写入的场景,使用 os.OpenFile 打开文件,再通过 file.WriteString 或 bufio.NewWriter 进行缓冲写入,性能更佳:
file, err := os.OpenFile("log.txt", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)if err != nil { /* 处理错误 */ }
defer file.Close()
_, err = file.WriteString("new line\n")
其他常用功能迁移
ioutil 包的其他功能也有明确的替代:
- 读取目录:ioutil.ReadDir → os.ReadDir
- 创建临时文件:ioutil.TempFile → os.CreateTemp
- 创建临时目录:ioutil.TempDir → os.MkdirTemp
- Reader 转 ReadCloser:ioutil.NopCloser → io.NopCloser
- 丢弃写入数据:ioutil.Discard → io.Discard (原本就在 io 包)
基本上就这些,迁移过程直接替换函数名和导入包即可,用法基本一致。










