go 1.16起ioutil包被移除，需改用os.readfile、os.writefile、os.mkdirtemp和io.readall；注意参数变化、权限前缀0o、空目录路径panic及fs.direntry新接口。
为什么 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 旧版一样，但很多人误以为它会。
立即学习“go语言免费学习笔记（深入）”；
- 如果路径含多级不存在目录（如
"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"）。
而旧 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 字段）。
- 若只需文件名列表，用
os.ReadDir更轻量 - 若需大小、修改时间等完整信息，调
entry.Info()，但注意它可能触发额外系统调用 - 别直接替换为
filepath.WalkDir——那是遍历子树，不是读单个目录
迁移本身不难，难的是那些散落在各处、没加测试的 ioutil 调用，尤其在工具函数或老 glue code 里。grep 一遍 import.*ioutil 和 \.ioutil\. 最稳妥。
