本文介绍如何在Go中高效读取以空行分隔的多行文本块（如配置段落），涵盖标准bufio.Scanner的默认行为、自定义分块逻辑实现，以及避免常见陷阱（如仅读取首块）的完整解决方案。
本文介绍如何在go中高效读取以空行分隔的多行文本块（如配置段落），涵盖标准`bufio.scanner`的默认行为、自定义分块逻辑实现，以及避免常见陷阱（如仅读取首块）的完整解决方案。
在Go中处理以空行（\n\n）为分隔符的多行文本（例如INI风格配置块、YAML文档片段或日志事件组），不能直接依赖bufio.Scanner默认的ScanLines行为——它仅按单换行符\n切分，会将一个逻辑“块”错误地拆成多行。虽然可自定义SplitFunc，但需特别注意边界条件（如文件末尾无空行、连续空行、首尾空行等），稍有不慎就会漏读或panic。
最稳健、清晰且符合Go惯用法的方式，是不修改Scanner的分割逻辑，而是在扫描过程中主动累积与分块。这种方式逻辑直观、易于调试、容错性强，且无需手动处理字节切片和CR/LF兼容性问题。
以下是一个生产就绪的实现示例：
package main
import (
"bufio"
"fmt"
"os"
"strings"
)
// readBlocks 从reader中读取所有以空行分隔的文本块，每个块为字符串切片
func readBlocks(reader *bufio.Reader) ([][]string, error) {
var blocks [][]string
var currentBlock []string
scanner := bufio.NewScanner(reader)
for scanner.Scan() {
line := strings.TrimSpace(scanner.Text()) // 去首尾空白，便于判断空行
// 遇到空行：提交当前块（若非空），并重置
if line == "" {
if len(currentBlock) > 0 {
blocks = append(blocks, currentBlock)
currentBlock = nil
}
continue
}
// 非空行：加入当前块
currentBlock = append(currentBlock, scanner.Text()) // 保留原始格式（含缩进/引号）
}
// 文件结束时，检查是否还有未提交的块
if len(currentBlock) > 0 {
blocks = append(blocks, currentBlock)
}
if err := scanner.Err(); err != nil {
return nil, fmt.Errorf("scan error: %w", err)
}
return blocks, nil
}
func main() {
// 示例数据（实际使用中可替换为 os.Open("config.txt")）
data := `Name = "John"
Surname = "Smith"
Val1 = 700
Val2 = 800
Name = "Pete"
Surname = "Jones"
Val1 = 555
Val2 = 666
Val3 = 444
`
reader := bufio.NewReader(strings.NewReader(data))
blocks, err := readBlocks(reader)
if err != nil {
panic(err)
}
// 打印解析结果
for i, block := range blocks {
fmt.Printf("Block %d (%d lines):\n", i+1, len(block))
for _, line := range block {
fmt.Printf(" | %s\n", line)
}
fmt.Println()
}
}✅ 关键设计说明：
立即学习“go语言免费学习笔记（深入）”；
- 使用 strings.TrimSpace() 判断空行，兼顾 \r\n 和 \n 场景下的空白字符；
- 显式检查 scanner.Err()，确保I/O错误不被忽略；
- currentBlock 在每次提交后设为 nil（而非 []string{}），避免底层数组残留引用；
- 保留原始 scanner.Text() 内容（而非 TrimSpace 后的），保证字段值（如 "John" 中的引号）不被意外截断。
⚠️ 为什么不推荐自定义 SplitFunc？
虽然 bufio.SplitFunc 理论上可行，但 bytes.IndexAny(data, "\n\n") 存在严重缺陷：它仅查找两个相邻换行符，无法处理跨缓冲区的空行（如 \n 在缓冲区末尾、下一个 \n 在下一块开头），且需手动处理 \r\n\r\n、UTF-8 BOM、以及 atEOF 时的边界状态。官方文档也明确指出：“Custom split functions are advanced and error-prone”。
? 扩展建议：
若需进一步解析每个块为结构体（如 Person{Name, Surname, Val1, ...}），可在 readBlocks 后添加 parseBlock(block []string) 函数，使用正则或 strings.SplitN(line, "=", 2) 提取键值对，并调用 strconv.Atoi 或 json.Unmarshal 转换数值。
此方案简洁、健壮、可测试、易维护，是处理空行分隔文本的Go最佳实践。
