os.ReadFile是Go 1.16+官方推荐的小文件读取方式，完全替代已弃用的ioutil.ReadFile；它自动处理Open/ReadAll/Close，签名一致，仅需替换包名，性能略优且错误更清晰。
os.ReadFile 读取小文件时比 ioutil.ReadFile 更直接
Go 1.16 起 ioutil.ReadFile 已被弃用，os.ReadFile 是官方推荐替代。它省去手动打开、关闭文件和读取缓冲的步骤，适合一次性读取内容不大的文件（一般建议 ≤ 10MB）。
常见错误是误传目录路径或权限不足导致 "is a directory" 或 "permission denied" 错误；此时应先用 os.Stat 检查路径是否为文件。
-
os.ReadFile返回[]byte，若需字符串，直接转：string(data) - 不支持读取超过内存容量的超大文件——会触发 OOM，此时必须改用
os.Open+io.Copy - 底层仍调用
os.Open和ReadAll，所以对同一文件高频调用会有重复 open/close 开销
os.WriteFile 默认覆盖写入，小心误删原内容
os.WriteFile 的行为是「原子性覆盖」：先写入临时文件，再 rename 替换原文件。这意味着它不会追加、不会保留原文件任何内容，也不检查原文件是否存在。
典型误用场景：想追加日志却用了 os.WriteFile，结果日志全丢；或者没处理错误就继续执行，导致后续逻辑基于空文件运行。
- 第三个参数是
perm（如0644），不是 flag —— 传os.O_APPEND会静默失败 - 如果目标路径存在 symlink，
os.WriteFile会替换 symlink 指向的目标文件，而不是 symlink 本身 - 在 NFS 或某些容器文件系统上，
rename可能跨设备失败，此时需降级为手动 write + chmod
读写组合使用时要注意编码与换行一致性
Go 的 os.ReadFile 和 os.WriteFile 都只处理原始字节，不做文本编码推断。如果你读的是 UTF-8 文件但含 BOM，或写入 Windows 换行符 \r\n 却在 Linux 下读，内容可能显示异常，但不会报错。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
尤其在配置文件、JSON、TOML 场景下，这类问题容易被忽略，直到下游解析失败才暴露。
- 读取后建议用
strings.TrimSpace或bytes.TrimSpace去首尾空白，避免因编辑器自动加空行导致解析失败 - 写入前确认字符串已按目标平台规范处理换行：
strings.ReplaceAll(s, "\n", "\r\n")（仅当明确需要 CRLF） - 若涉及非 UTF-8 编码（如 GBK），必须用第三方库（如
golang.org/x/text/encoding）显式解码，不能依赖os.ReadFile
错误处理不能只判 nil，要区分具体错误类型
os.ReadFile 和 os.WriteFile 返回的 error 多数来自底层 syscall，比如 ENOENT、EACCES、ENOSPC。只写 if err != nil 往往不够，尤其在 CLI 工具或服务中需给出用户可操作的提示。
例如磁盘满时写入失败，返回的 err 是 *fs.PathError，其 Err 字段才是 ENOSPC；直接打印 err.Error() 只显示 “no space left on device”，但无法知道是哪个路径的问题。
- 用
errors.Is(err, fs.ErrNotExist)判断文件不存在，比字符串匹配更可靠 - 用
os.IsPermission(err)区分权限不足和路径不存在，避免误导用户去创建错的父目录 - 写入前可用
os.Stat(filepath.Dir(path))提前验证目录可写，减少静默失败
真正麻烦的不是 API 本身，而是路径拼接出错、权限继承混乱、以及把二进制读写当成文本处理——这些都不会在编译时报错，但会在某个特定环境里突然崩掉。
