Golang IO/Ioutil包废弃后的替代方案_使用OS与IO包新函数-Golang-PHP中文网

Go 1.16起ioutil包被移除，需改用os.ReadFile、os.WriteFile、os.MkdirTemp和io.ReadAll；注意参数变化、权限前缀0o、空目录路径panic及fs.DirEntry新接口。

golang io/ioutil包废弃后的替代方案_使用os与io包新函数

为什么 `ioutil.ReadFile` 突然报错：undefined？

Go 1.16 起，ioutil 包被正式移除，所有函数（如 ioutil.ReadFile、ioutil.WriteFile、ioutil.TempDir）都不再可用。不是弃用警告，是直接编译失败。

这不是版本兼容问题，而是标准库主动清理——ioutil 的功能已全部下沉到 os 和 io 包中，接口更统一，语义更清晰。

ioutil.ReadFile → 改用 os.ReadFile
ioutil.WriteFile → 改用 os.WriteFile
ioutil.TempDir → 仍为 os.MkdirTemp（但注意参数顺序变了）
ioutil.ReadAll → 仍为 io.ReadAll（位置没变，只是不再从 ioutil 导入）

`os.ReadFile` 和旧 `ioutil.ReadFile` 行为一致吗？

几乎完全一致：都以 []byte 返回文件内容，出错返回 error，内部默认使用 0o644 权限（对读操作无影响）。

但关键差异在错误处理细节：os.ReadFile 在文件不存在时返回 os.IsNotExist(err) 为 true 的 error，和以前一样；但它**不会自动创建父目录**——这点和 ioutil.WriteFile 旧版一样，但很多人误以为它会。

如果路径含多级不存在目录（如 "data/logs/app.log"），os.WriteFile 会直接报 no such file or directory
必须提前用 os.MkdirAll("data/logs", 0o755) 创建父目录
os.WriteFile 的第三个参数是 perm os.FileMode，不是 int，别传 0644（缺 0o 前缀会变成八进制 644 十进制 420，权限错乱）

临时目录创建：为什么 `os.MkdirTemp` 的参数顺序让人容易写反？

os.MkdirTemp 是 ioutil.TempDir 的替代，但签名是 os.MkdirTemp(dir, pattern string) (string, error) —— 第一个参数是父目录路径，第二个才是模板名（如 "myapp-*.tmp"）。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

而旧 ioutil.TempDir 是 ioutil.TempDir(dir, prefix string)，看起来一样，但很多代码习惯性把 "" 当第一个参数（想表示“系统默认 tmp 目录”），结果传成 os.MkdirTemp("", "prefix")，触发 panic：mkdir: invalid argument（空字符串 dir 不被接受）。

正确写法：用 os.TempDir() 显式获取系统临时目录路径，再传给 os.MkdirTemp
例如：os.MkdirTemp(os.TempDir(), "myapp-*.tmp")
别依赖 ""，os.MkdirTemp 不支持空 dir

迁移后性能有变化吗？要不要自己封装一层？

没有实质性能差异。os.ReadFile 底层仍是 os.Open + io.ReadAll，和旧 ioutil.ReadFile 实现逻辑一致；os.WriteFile 也复用了 os.OpenFile + Write + Close 流程。

但要注意：如果你项目里曾用 ioutil.ReadDir（它没被移到 os），现在得改用 os.ReadDir（返回 []fs.DirEntry）或 os.ReadDir + entry.Info()，因为 fs.ReadDir 是 Go 1.16 新增的抽象，行为略有不同（比如不保证排序，且 DirEntry 不含完整 os.FileInfo 字段）。