应改用 os.ReadFile 替代 ioutil.ReadFile，因后者在 Go 1.16 已弃用；os.ReadFile 行为一致、自动关闭文件，而需精细控制时则拆用 os.Open + io.ReadAll。
别用 io/ioutil 了，它在 Go 1.16 已被弃用，所有函数都移到 io 和 os 包里；继续用会触发警告，且无法享受新版本的底层优化。
为什么 ioutil.ReadFile 不再推荐
Go 官方明确将 io/ioutil 标记为“deprecated”，不是因为功能有问题，而是为了厘清职责：os 处理文件系统操作，io 处理流式读写。硬塞一个包里反而模糊边界。
- Go 1.16+ 编译时会输出
"io/ioutil is deprecated: as of Go 1.16, the same functionality is now provided by package io and package os" -
ioutil.ReadFile底层实际调用的是os.Open+io.ReadAll，现在你直接组合这两个更清晰 - 迁移成本极低，一行替换即可
等价替代：用 os.ReadFile 替代 ioutil.ReadFile
最直接的替换方案 —— os.ReadFile 是 Go 1.16 新增的函数，行为、签名、错误处理逻辑与旧版完全一致，只是包路径变了。
data, err := os.ReadFile("config.json")
if err != nil {
log.Fatal(err)
}
fmt.Println(string(data))
- 返回
[]byte，和原来一样，不自动转string - 内部做了
os.Open→io.ReadAll→Close全流程，无需手动关文件 - 比手写
os.Open+io.ReadAll更简洁，且语义明确（就是“读整个文件”）
需要控制读取行为？用 os.Open + io.ReadAll
如果要加超时、限制大小、或复用已有 *os.File，就不能用 os.ReadFile，得拆开处理。
立即学习“go语言免费学习笔记（深入）”；
-
os.Open返回*os.File，可做权限检查、stat、seek 等操作 -
io.ReadAll接收任意io.Reader，不限于文件；也支持传入带上下文的io.LimitReader防止 OOM - 必须显式调用
file.Close()，漏掉会泄露文件描述符
file, err := os.Open("large.log")
if err != nil {
log.Fatal(err)
}
defer file.Close() // 别忘了
// 限制最多读 10MB
limited := io.LimitReader(file, 10*1024*1024)
data, err := io.ReadAll(limited)
if err != nil {
log.Fatal(err)
}
常见错误和坑点
迁移过程中最容易栽在三个地方：
- 忘记改 import：删掉
"io/ioutil"，加上"os"或"io" - 误以为
os.ReadFile自动解码 UTF-8：它只返回原始字节，string(data)是强制转换，不校验编码有效性 - 在循环中反复调用
os.ReadFile读大文件：它每次都会重新打开+读全量，性能差；应缓存结果或改用流式读取 - 用
io.ReadAll读网络响应体但没defer resp.Body.Close()：HTTP 客户端连接不会复用，很快耗尽
真正关键的不是“怎么读”，而是“谁负责关”和“读多大”。os.ReadFile 把前者藏好了，后者仍需你判断。
