本文介绍使用 bufio.scanner 逐行读取文件并定位目标字符串首次出现的行号，同时扩展支持多行匹配、全文件扫描及并发处理海量文件的完整实践方案。
本文介绍使用 bufio.scanner 逐行读取文件并定位目标字符串首次出现的行号，同时扩展支持多行匹配、全文件扫描及并发处理海量文件的完整实践方案。
在 Go 中，直接将整个文件读入内存（如用 ioutil.ReadFile）虽简单，但无法获取行号，且对大文件不友好。更健壮、内存友好的方式是流式逐行扫描——这正是 bufio.Scanner 的核心优势。
以下是一个基础但完整的实现，用于查找字符串首次出现的行号（从 1 开始计数）：
import (
"bufio"
"fmt"
"os"
"strings"
)
func findFirstLine(path, target string) (int, error) {
f, err := os.Open(path)
if err != nil {
return 0, fmt.Errorf("failed to open %s: %w", path, err)
}
defer f.Close()
scanner := bufio.NewScanner(f)
lineNum := 1
for scanner.Scan() {
line := scanner.Text()
if strings.Contains(line, target) {
return lineNum, nil
}
lineNum++
}
if err := scanner.Err(); err != nil {
return 0, fmt.Errorf("scan error in %s: %w", path, err)
}
return 0, fmt.Errorf("string %q not found in %s", target, path)
}若需报告所有匹配行号（而非仅首个），只需将 return 改为收集结果：
func findAllLines(path, target string) ([]int, error) {
f, err := os.Open(path)
if err != nil {
return nil, fmt.Errorf("failed to open %s: %w", path, err)
}
defer f.Close()
var matches []int
scanner := bufio.NewScanner(f)
lineNum := 1
for scanner.Scan() {
if strings.Contains(scanner.Text(), target) {
matches = append(matches, lineNum)
}
lineNum++
}
if err := scanner.Err(); err != nil {
return nil, fmt.Errorf("scan error in %s: %w", path, err)
}
return matches, nil
}✅ 注意事项与最佳实践：
- bufio.Scanner 默认按 \n 分割，自动处理 \r\n（Windows）和 \n（Unix），无需额外适配；
- 避免使用 scanner.Bytes() 直接比对字节切片（易因编码/换行符差异出错），优先用 scanner.Text() 转为 string 后调用 strings.Contains；
- 若需区分大小写或支持正则匹配，可替换 strings.Contains 为 strings.ContainsFold 或 regexp.MustCompile(...).MatchString；
- 对超大文件（GB 级），Scanner 仍保持常量内存占用（默认缓冲区 64KB），远优于 ReadFile；
- 处理“数千个文件”时，应构建goroutine 工作池（Worker Pool），限制并发数防资源耗尽，示例可参考 Go by Example: Worker Pools。
总结：bufio.Scanner 是 Go 中行级文本处理的标准工具。它轻量、安全、可控，配合清晰的错误处理与灵活的结果收集逻辑，即可满足从单文件调试到批量日志分析的各种字符串定位需求。
