bufio.Scanner逐行读取文件最常用且安全,但超长行、二进制内容或需错误定位时不适用;默认单行上限64KB,超限报ErrTooLong,调试困难;支持超长行需调用scanner.Buffer()。

用 bufio.Scanner 逐行读取文件最常用、也最安全,但不是所有场景都适合——比如超长行、二进制内容、需要错误定位时,得换方案。
用 bufio.Scanner 读文本行(默认推荐)
它内部带缓冲、自动处理换行符、内存友好,适合绝大多数日志、配置、CSV 等纯文本场景。
注意:默认单行上限是 64KB,超长行会直接报 scanner.ErrTooLong;不暴露底层 io.Reader 错误细节,调试困难。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 用
scanner.Scan()循环读取,每次调scanner.Text()获取当前行(不含换行符) - 需支持超长行?提前调
scanner.Buffer(make([]byte, 64*1024), 1 扩容缓冲区 - 遇到空行或注释行,
strings.TrimSpace(scanner.Text())再判断更稳妥 - 别在循环里用
scanner.Bytes()后还保留引用——底层切片可能被下一次Scan()覆盖
用 bufio.Reader.ReadString('\n') 精确控制换行行为
当你需要区分 \n 和 \r\n、处理混合换行格式、或必须拿到原始字节(含换行符本身)时,这个更合适。
常见错误现象:读到最后一行没换行符时返回 io.EOF,但内容其实已读到——容易漏掉末尾一行。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 每次调
reader.ReadString('\n'),检查错误是否为io.EOF或io.ErrUnexpectedEOF - 若遇
io.EOF且上次读到非空字符串,那字符串就是最后一行(无换行符) - 想兼容 Windows 行尾?手动用
strings.TrimSuffix(line, "\r\n"); strings.TrimSuffix(line, "\n") - 比
Scanner多一次内存拷贝,性能略低,但可控性高
大文件或需错误位置时,用 bufio.Reader.ReadBytes('\n') + 自定义解析
当某一行出错要打印「第几行第几个字符」,或者内容含非法 UTF-8 字节(如日志混入二进制 dump),Scanner 会静默失败或 panic,这时必须自己掌控字节流。
性能影响:频繁小内存分配,建议复用 bytes.Buffer 或预分配切片。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 用
reader.ReadBytes('\n')读到含换行符的字节切片,再用bytes.TrimSuffix()去掉换行符 - 记录累计读取字节数 + 当前行长度,就能算出行号和列号
- 遇到
io.EOF且返回切片非空,说明最后一行没换行符,直接处理 - 对非 UTF-8 数据,避免用
string()强转,优先用bytes.Contains()等字节操作
真正麻烦的从来不是“怎么读”,而是“读错了怎么知道错在哪”——Scanner 简洁但藏错,ReadString 折中,ReadBytes 繁琐但透明。选哪个,取决于你愿不愿意为可观测性多写三行代码。










