必须检查错误并预检路径:os.Open/os.Create不自动创建父目录,需用os.MkdirAll;文件操作后须defer f.Close()但先判错;读写小文件优先用os.ReadFile/os.WriteFile,大文件用bufio.Scanner逐行处理。

用 os.Open 和 os.Create 打开文件前必须检查错误
Go 的 os.Open 和 os.Create 不会自动创建父目录,也不处理路径不存在的场景。常见错误是直接对 os.Open("data/config.json") 调用而没确认 data/ 目录是否存在,结果得到 "no such file or directory" 错误。
实操建议:
- 用
os.Stat或os.MkdirAll预检路径:os.MkdirAll("data", 0755) -
os.Create在文件存在时会截断内容,如需追加,请改用os.OpenFile(path, os.O_APPEND|os.O_WRONLY, 0644) - 所有
*os.File对象必须显式Close(),推荐用defer f.Close(),但注意:如果f是nil(比如os.Open失败返回),defer nil.Close()会 panic —— 所以务必先判错再 defer
读文件别直接用 ioutil.ReadFile(已弃用),改用 os.ReadFile
ioutil.ReadFile 在 Go 1.16+ 已被标记为 deprecated,新项目必须用 os.ReadFile。它本质是封装了 os.Open + io.ReadAll,适合小文件一次性读取。
但要注意:
立即学习“go语言免费学习笔记(深入)”;
- 它把整个文件加载进内存,读取 GB 级日志会 OOM;大文件请用
bufio.Scanner或io.Copy - 返回的
[]byte是只读副本,修改它不影响磁盘文件 -
编码问题不在此函数职责内 —— 它不解析 UTF-8 BOM,也不做字符集转换,后续需手动用
strings.ToValidUTF8或第三方库处理
示例:data, err := os.ReadFile("config.yaml")
写文件时优先用 os.WriteFile,但注意权限掩码行为
os.WriteFile 是 os.Create + Write + Close 的快捷封装,适合覆盖写入小文件。但它第三个参数是 perm FileMode,不是“保留原权限”,而是“新建文件时使用的权限位”。
关键点:
- 在 Linux/macOS 上,实际创建权限受 umask 影响,
0644可能最终变成0600;如需强制权限,得用os.Chmod补一手 - 该函数总是覆盖写,无法原子替换(避免写到一半崩溃导致损坏);生产环境更新配置文件应写临时文件 +
os.Rename - Windows 下
0644会被忽略,文件默认可读写,权限控制靠 ACL,这点常被跨平台项目忽略
按行读取大文件必须用 bufio.Scanner,别用 ReadString('\n')
bufio.Scanner 是 Go 官方推荐的大文件逐行读取方式,底层复用缓冲区、自动处理换行符边界、支持自定义分隔符。而手写 ReadString('\n') 容易卡在超长行或二进制数据中(比如日志含 \x00)。
典型陷阱:
-
Scanner默认单行上限 64KB,超长行会报"scanner token too long";需提前调Scan.Bytes()前设sc.Buffer(make([]byte, 0, 1024*1024), 1024*1024) - 它不返回行尾的
\n,如需保留,请用bufio.Reader.ReadLine()(但注意它不自动处理 CRLF) - 不要在循环里重复声明
var sc *bufio.Scanner,应该复用一个实例,否则可能泄漏底层bufio.Reader缓冲区
复杂点在于:没有“读到某一行就停”的内置方法,必须自己 break;也没有“跳过前 N 行”的捷径 —— 这些都得手动计数。










