为什么 Go 1.16 后不建议使用 io/ioutil 包？

从 Go 1.16 开始，io/ioutil 这个包彻底告别了舞台——不是“不推荐使用”，是直接没法用了。你只要在代码里写上 import "io/ioutil"，编译器立刻报错：undefined: ioutil。对，就是这么干脆。

这个改动没有缓冲期。你代码里但凡出现 ioutil.ReadFile、ioutil.WriteFile、ioutil.TempDir，升级到 Go 1.16+ 后全部失效。 如果项目还卡在旧版本，可能暂时不受影响，但只要往新版本走，这一步绕不开。

Go 1.16+ 编译报错：undefined: ioutil

不是警告，是全面清除。常见状况包括：

• import "io/ioutil" 直接编译失败
• ioutil.ReadFile、ioutil.WriteFile、ioutil.TempDir 等所有函数全部报错
• 即便旧项目能在 Go 1.15 跑通，升级后这些都得改

os.ReadFile 和 io.ReadAll 行为一致，但权限和路径更严格

替换不能只是简单换个函数名，几个容易踩坑的地方值得注意：

• os.ReadFile("config.json") 功能上和旧版一致，返回 []byte 和 error，但它不会帮你创建父目录——假如 ./etc/config.json 里的 etc/ 目录不存在，它会直接报 no such file or directory。
• os.WriteFile("a/b/c.txt", data, 0644) 这种写法是错的。权限值必须带上 0o 前缀，写成 0o644。如果写成 0644，Go 会把它当作八进制字面量（其实是十进制 420），结果权限变成 -w----x--x，非常隐蔽。
• os.MkdirTemp("", "prefix") 会 panic：报 mkdir: invalid argument。空字符串 "" 不被接受，必须显式传 os.TempDir()。

大文件读取别碰 ReadFile，无论新旧

os.ReadFile 和已被移除的 ioutil.ReadFile 行为完全一样——一次性把整个文件塞进内存。这不是风格问题，是实实在在的资源风险：

• 读 100 MB 文件，实际可能占用 200+ MB 内存（Go 字符串底层拷贝 + slice 头）。
• 在容器或 CI 环境里，很容易触发 OOM Killer 把进程干掉。
• 更合理的做法是：os.Open + bufio.Scanner（处理文本行）、io.Copy（处理二进制流），或者手动分块读取。

临时文件创建：CreateTemp 默认更安全，但清理要自己管

os.CreateTemp 替代了原来的 ioutil.TempFile，函数签名一样，但默认权限改为 0o600（仅属主可读写），比旧版更合理。不过要注意：

• 它不会自动清理——文件创建后，必须显式调用 os.Remove 或 defer f.Close(); os.Remove(f.Name())。
• 用于测试时，推荐配合 os.MkdirTemp 先建临时目录，再在里面创建文件，最后用 os.RemoveAll 一次性清理。
• ioutil.ReadDir 没有直接对应的函数，得改用 os.ReadDir（返回 []fs.DirEntry，不是 []os.FileInfo），接口有变化，需要留意。

最常被忽略的一点：迁移不只是改函数名。像 os.MkdirTemp 和 os.CreateTemp 的第一个参数不能为空，os.WriteFile 的权限值必须是 fs.FileMode 类型且带 0o 前缀——这些细节编译时不会报错，但运行时才暴露，尤其在跨平台或不同 umask 环境下。