GolangIO包文件读写详解

本文深入解析了 Go 语言中文件读写的核心实践与常见陷阱，强调必须严格检查错误、预检路径（如用 os.MkdirAll 创建父目录）、避免 defer nil.Close() 导致 panic，并系统对比了小文件（推荐 os.ReadFile/os.WriteFile）与大文件（必须用 bufio.Scanner 逐行处理）的最优方案；同时揭露了权限掩码受 umask 影响、Windows 权限失效、Scanner 默认缓冲限制、编码与换行符处理等易被忽视的关键细节，为开发者提供安全、高效、跨平台的 IO 操作指南。

用 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，适合小文件一次性读取。

但要注意：

• 它把整个文件加载进内存，读取 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 行”的捷径 —— 这些都得手动计数。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。