os.WriteFile不会递归创建父目录,需先用os.MkdirAll确保路径存在;权限参数在Windows上被忽略;覆盖写入不支持追加;判断文件不存在必须用os.IsNotExist(err),且需先检查err!=nil。

os.WriteFile 会自动创建文件,但父目录必须存在
直接调用 os.WriteFile 写入一个路径不存在的文件时,它**不会递归创建中间目录**。如果 "logs/app.log" 中的 logs/ 目录不存在,会报错 no such file or directory,而不是静默失败。
- 正确做法是先确保父目录存在:
os.MkdirAll(filepath.Dir(path), 0755) -
os.WriteFile的权限参数(如0644)在 Windows 上被忽略,实际由系统 ACL 控制 - 该函数总是覆盖写入,不支持追加;需追加请改用
os.OpenFile配合os.O_APPEND
用 os.OpenFile + os.O_CREATE 创建文件时,注意 flag 组合陷阱
常见误写:os.OpenFile(path, os.O_CREATE|os.O_WRONLY, 0644) —— 这个组合在文件已存在时能写入,但若路径中任一父目录缺失,仍会失败,且不会提示“目录不存在”,错误类型仍是 os.ErrNotExist。
- 要确保创建行为可靠,必须提前建好父目录,或捕获并识别
os.IsNotExist(err)后再调用os.MkdirAll - 若想“文件存在则失败”,加
os.O_EXCL:比如os.O_CREATE | os.O_EXCL,此时文件已存在会返回非 nil 错误 - 避免只读模式下写入:用
os.O_WRONLY或os.O_RDWR,别用os.O_RDONLY然后调WriteString
判断“文件不存在”必须用 os.IsNotExist,不能靠 err == nil 反推
很多人写 _, err := os.Stat(path); if err != nil { /* 假设就是不存在 */ } —— 这很危险。因为 err != nil 可能是权限拒绝、路径过长、设备忙等,和“不存在”无关。
- 唯一安全方式是:
if os.IsNotExist(err) { ... } -
os.IsNotExist(nil)会 panic,所以必须先确认err != nil再调用 - 对
os.OpenFile、os.Remove、os.Stat等返回的 error 才有效;自定义错误或字符串错误传进去永远返回 false
写入失败后,别忽略 close 错误,也别 defer nil 文件
典型崩溃场景:file, err := os.OpenFile(path, os.O_WRONLY, 0644) 失败 → err != nil → 但后面还写了 defer file.Close() → 因为 file 是 nil,触发 panic:invalid memory address or nil pointer dereference。
-
defer file.Close()必须放在if err != nil检查之后,且保证file非 nil - 即使写入成功,
file.Close()也可能失败(如磁盘满、NFS 断连),建议检查其返回 error - 批量操作多个文件时,不要共用一个
defer;每个打开的*os.File应单独处理关闭逻辑
真正容易被忽略的是:错误类型判断必须分层做。比如先用 os.IsNotExist 判断是否要建目录,再用 os.IsPermission 判断是否要提权,最后才 fallback 到通用日志。混在一起用 err.Error() 字符串匹配,上线后换系统或升级 Go 版本就可能失效。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











