go文件读写应优先用os.readfile/writefile处理小文件,大文件用bufio.scanner逐行读取,os.openfile精确控制模式权限,注意编码、换行符及错误检查。

Go 语言的文件读写不依赖第三方库,os 和 io 包已足够可靠,但直接用 os.Open 或 os.Create 容易忽略错误处理、资源泄漏和编码边界问题。
用 os.ReadFile 和 os.WriteFile 快速读写小文件
这是最简方式,适合配置文件、JSON、日志片段等几 MB 以内的内容。它自动处理打开、读取/写入、关闭全过程,无需手动调用 Close()。
注意:这两个函数在 Go 1.16+ 才引入;低于该版本需用 ioutil.ReadFile(已弃用)或手动组合 os.Open + io.ReadAll。
-
os.ReadFile返回[]byte,不是string—— 若需字符串,显式转:string(data) -
os.WriteFile第三个参数是文件权限(如0644),Windows 上会被忽略,但必须传(不能为 0) - 大文件(>50MB)慎用,会一次性加载进内存
用 bufio.Scanner 按行读取文本文件
当文件较大或只需逐行处理(如日志分析、CSV 解析),bufio.Scanner 是更安全的选择,它默认限制每行最大 64KB,避免 OOM。
立即学习“go语言免费学习笔记(深入)”;
常见错误是忽略 Scan() 的返回值,导致最后一行漏读或 panic:
file, _ := os.Open("log.txt")
scanner := bufio.NewScanner(file)
for scanner.Scan() {
line := scanner.Text() // 不要在这里调 scanner.Bytes() + scanner.Text() 混用
fmt.Println(line)
}
if err := scanner.Err(); err != nil {
log.Fatal(err) // 必须检查 scanner.Err()
}
- 默认分隔符是换行符,可通过
scanner.Split(bufio.ScanLines)自定义 - 若某行超长,会触发
scanner.Err() == bufio.ErrTooLong,需提前用scanner.Buffer扩容 - 不要在循环中重复
os.Open—— 一个*os.File可复用多次
用 os.OpenFile 精确控制读写模式与权限
当需要追加写入、读写并存、或设置特殊权限(如仅用户可读写),os.OpenFile 是唯一选择。它的第二个参数是 flag 组合,容易出错。
典型误用:os.OpenFile(path, os.O_WRONLY|os.O_CREATE, 0) —— 权限为 0 会导致创建失败(Linux 下等价于 ---x--x--x)。
- 常用 flag 组合:
os.O_RDWR | os.O_CREATE | os.O_TRUNC(读写+创建+清空);os.O_WRONLY | os.O_CREATE | os.O_APPEND(追加) - 权限位必须用八进制字面量:
0600(仅所有者读写)、0644(所有者读写,组和其他人只读) - Windows 下权限参数被忽略,但代码仍需传,否则行为未定义
- 务必配对
defer f.Close(),且放在os.OpenFile成功之后
读写时的编码与换行符陷阱
Go 原生只处理字节流,不自动识别 UTF-8 BOM、Windows CRLF 或 GBK 编码。如果你读到中文乱码,大概率是源文件用了非 UTF-8 编码,而你直接当 UTF-8 解释了。
换行符也常被忽视:fmt.Fprintln 总是写 \n,但 Windows 用户可能期望 \r\n —— Go 不做自动转换,需自行处理。
- 检测 BOM:读取前几个字节,用
unicode/utf8或第三方包(如golang.org/x/text/encoding)做转码 - 写入换行符统一用
\n即可,绝大多数现代工具(包括 Windows 上的 VS Code、Notepad++)都能正确识别 - 避免用
fmt.Sprint拼接路径或文件名 —— 用path/filepath.Join处理跨平台路径分隔符
真正麻烦的从来不是“怎么读”,而是“读错了没发现”——比如权限不足却静默失败、BOM 导致 JSON 解析报错、追加写时忘了 O_APPEND 导致覆盖。把这些检查点写进单元测试,比记住所有 API 更重要。










