os.OpenFile是唯一能精确控制文件行为的入口,os.Open和os.Create只是其固定参数的封装;需组合flag(如O_RDONLY|O_CREATE)和perm实现安全读、追加写、权限保留等需求。

别用 os.Open 读可能不存在的文件,也别用 os.Create 做追加写——Go 文件操作不是选函数,是拼 os.OpenFile 的 flag 和 perm。
os.OpenFile 是唯一能精确控制行为的入口
os.Open 和 os.Create 都只是 os.OpenFile 的封装,但封装太死:前者固定只读且不创建,后者固定覆写+0644权限+无追加能力。真要安全读、追加写、保留权限、原子创建,必须自己组合 flag。
-
os.O_RDONLY | os.O_CREATE:只读打开,文件不存在时创建空文件(注意:这不是“只读不创建”,而是“读失败就建空”) -
os.O_WRONLY | os.O_APPEND | os.O_CREATE:追加写,文件不存在则新建,存在则末尾追加 -
os.O_RDWR | os.O_CREATE | os.O_EXCL:仅当文件不存在时创建并可读写,否则报os.ErrExist,适合锁文件或原子初始化 - 权限位(如
0600)只在带os.O_CREATE时生效;Windows 上会被忽略,Linux/macOS 才起作用
os.ReadFile / os.WriteFile 只适合小文件一次性搬运
这两个函数省事,但掩盖了底层行为:它们内部调用 os.OpenFile + 全量读/写 + 关闭,不支持流式处理,也不暴露错误细节。
-
os.ReadFile读 >100MB 文件容易触发 OOM,别用;配置文件、JSON、模板文本很合适 -
os.WriteFile总是覆写整个文件,哪怕只改一行也要重写全部内容,且在 Windows 上若文件正被其他进程打开,会直接报The process cannot access the file because it is being used by another process - 想保留原文件权限?
os.WriteFile固定用传入的 perm,不管原文件是什么——得用os.OpenFile+os.Stat+os.Chmod手动还原
逐行读文件,Scanner 不可靠,bufio.Reader 更稳
bufio.Scanner 默认按 \n 切分,但遇到末尾无换行符的文件时,最后一行静默丢失,且不报错。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 检查是否漏读:循环结束后调
scanner.Err(),若为nil但scanner.Text()有值,说明最后一行没进循环 - 更稳妥方式是用
bufio.NewReader(file).ReadString('\n'),它在 EOF 时明确返回io.EOF,不会静默截断 -
Scanner内部做 UTF-8 解码并跳 BOM,含\x00或二进制数据的文件会出错;这种场景必须换bufio.Reader.Read或file.Read
目录操作别混用 Mkdir 和 MkdirAll
os.Mkdir 只建单级目录,父路径不存在就失败;os.MkdirAll 会递归创建所有缺失的中间目录,但权限只应用在最后一级。
-
os.Mkdir("a/b/c", 0755):报错,因为a和a/b不存在 -
os.MkdirAll("a/b/c", 0755):成功创建a、a/b、a/b/c,但只有c是 0755,a和a/b权限由系统 umask 决定(通常 0755 或 0775) - 删除用
os.Remove(空目录)或os.RemoveAll(非空也删),但Remove对非空目录返回directory not empty错误,别当成 panic
flag 组合漏一个就失效,权限在 Windows 上无效,Scanner 末行静默丢数据——这些不是边缘 case,是日常踩坑点。写文件前先 os.Stat 看是否存在,读大文件别贪 os.ReadFile,路径拼接永远用 filepath.Join,不是字符串加号。

















