Go 1.16起应改用os.ReadFile替代已弃用的ioutil.ReadFile，因其错误来源清晰、自动管理文件生命周期且更安全；旧函数因错误模糊、无缓冲控制易致OOM和故障难定位。
Go 1.16 起 ioutil 已被弃用，直接用 os.ReadFile 更安全、更简洁；强行用旧包不仅会触发警告，还可能因忽略错误细节导致文件读取失败却无感知。
为什么不能再用 ioutil.ReadFile
该函数在 Go 1.16 中正式移入 io 包的弃用列表，实际位于 io/ioutil（已标记为 deprecated）。它底层调用 os.Open + io.ReadAll，但不暴露中间错误（比如权限不足时只报 readfile: permission denied，难定位是 open 还是 read 阶段出错）。
- 编译时会出现
io/ioutil: deprecated: use os.ReadFile instead警告 - 无法控制缓冲区大小，大文件易触发 OOM
- 返回的错误类型模糊，不利于针对性重试或日志记录
os.ReadFile 的正确用法和常见错误
这是当前标准做法，内部做了优化：自动处理 open → read → close 全流程，且错误来源清晰（基本都来自 syscall 或 fs 层）。
- 路径必须是绝对路径或相对于当前工作目录（
os.Getwd()可查） - 若文件不存在，错误为
*fs.PathError，可断言：if errors.Is(err, fs.ErrNotExist) { ... } - 读取空文件返回
[]byte{}和nil错误，不是nil切片 - 默认最大读取 100MB（由
io.ReadAll内部限制），超限会返回io.ErrUnexpectedEOF
读取大文件或需要流式处理时怎么办
os.ReadFile 本质是一次性加载全部内容进内存，不适合 GB 级日志或配置生成场景。此时应绕过它，手动控制读取节奏：
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Open获取*os.File，再配合bufio.Scanner按行读（适合文本） - 用
io.CopyN或io.ReadFull分块读取固定字节数 - 对 JSON/XML 等结构化数据，直接传
*os.File给json.NewDecoder解码，避免中间 []byte
例如按行读取：
file, err := os.Open("data.txt")
if err != nil {
log.Fatal(err)
}
defer file.Close()
scanner := bufio.NewScanner(file)
for scanner.Scan() {
line := scanner.Text() // 不包含 \n
fmt.Println(line)
}
if err := scanner.Err(); err != nil {
log.Fatal(err)
}
真正要注意的不是“怎么读”，而是“读多大”和“错在哪”——路径拼错、权限没开、磁盘满、编码非 UTF-8，这些都不会在 os.ReadFile 调用里体现出来，得靠错误值具体判断。
