Go 1.16+ 应使用 os.ReadFile 和 os.WriteFile 替代已弃用的 ioutil；需追加写或精细控制时用 os.OpenFile；路径用 filepath.Join 和 Clean 处理；替换配置文件须原子写入。
用 ioutil 还是 os？Go 1.16+ 应该选哪个
Go 1.16 起 ioutil 已被弃用，所有函数都迁移到 os 和 io 包。继续用 ioutil.ReadFile 会触发编译错误：undefined: ioutil.ReadFile。必须改用 os.ReadFile（读）和 os.WriteFile（写），它们更轻量、不依赖额外缓冲逻辑。
这两个函数适合小文件（一般 ≤ 10MB），接口简洁：
data, err := os.ReadFile("config.json")
if err != nil {
log.Fatal(err)
}
err = os.WriteFile("output.txt", []byte("hello"), 0644)
-
os.ReadFile内部自动调用os.Open+io.ReadAll，无需手动关闭文件 -
os.WriteFile会先创建临时文件再原子重命名，避免写入中途崩溃导致脏数据 - 权限参数（如
0644）只在文件新建时生效；若目标已存在，权限不变
os.OpenFile 是什么场景下必须用
当需要追加写、同时读写、或控制打开标志（O_APPEND、O_CREATE、O_TRUNC）时，os.ReadFile/os.WriteFile 就不够用了。比如日志追加、二进制流处理、或按块读大文件。
典型组合：
立即学习“go语言免费学习笔记（深入）”；
f, err := os.OpenFile("log.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
log.Fatal(err)
}
defer f.Close()
_, err = f.WriteString("2024-05-20 info: task done\n")
- 务必
defer f.Close()，否则文件句柄泄漏，Linux 下很快 hittoo many open files -
os.O_CREATE必须配合权限位，否则新建文件权限为 0000（不可读） - 不要用
os.O_RDWR打开文件后直接WriteString——默认写入位置在开头，会覆盖内容；需先f.Seek(0, io.SeekEnd)
中文路径或含空格的文件名打不开？
Go 本身支持 UTF-8 路径，问题通常出在 shell 环境或 IDE 配置。Windows 上常见错误：open C:\用户\test.txt: The system cannot find the path specified。
- 确认路径字符串未被意外转义：用原始字面量
`C:\用户\test.txt`或双反斜杠"C:\\用户\\test.txt" - 检查当前工作目录：用
os.Getwd()打印，别假设程序一定从项目根目录启动 - 路径拼接别手写
+，用filepath.Join("dir", "file.txt")，它会自动适配系统分隔符 - 如果路径来自用户输入（如命令行参数），用
filepath.Clean()过滤../跳转，防止路径遍历漏洞
如何安全地替换一个正在被其他进程读取的配置文件
直接 os.WriteFile("config.yaml", newBytes, 0644) 有风险：写入中途崩溃，原文件就丢了。稳妥做法是「写新 + 原子替换」：
tmpPath := filepath.Join(filepath.Dir("config.yaml"), "."+filepath.Base("config.yaml")+".tmp")
err := os.WriteFile(tmpPath, newBytes, 0644)
if err != nil {
return err
}
return os.Rename(tmpPath, "config.yaml")
-
os.Rename在同一文件系统内是原子操作，不会出现“只有半份新配置”的状态 - 注意：跨分区
Rename会失败，需 fallback 到os.Remove+os.WriteFile，但此时无法保证原子性 - 如果目标文件被其他进程以
FILE_SHARE_DELETE（Windows）或类似方式锁定，Rename可能失败，需捕获os.LinkError并重试
真正难的不是读写本身，而是判断什么时候该用 os.WriteFile，什么时候必须上 os.OpenFile + 手动管理；还有路径合法性、权限继承、原子性边界这些细节，一不留神就在线上吐错。
