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 级日志或配置生成场景。此时应绕过它，手动控制读取节奏：

• 用 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 调用里体现出来，得靠错误值具体判断。