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

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,支持自动创建文件、覆盖写入和权限设置。
立即学习“go语言免费学习笔记(深入)”;
- 第三个参数是文件权限(如
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",避免潜在的兼容性问题和静态分析告警。










