在Go语言处理文本文件读取的场景中，bufio.Scanner是标准库bufio包提供的轻量级扫描工具，它基于缓冲机制工作，能够按指定的分隔符逐段读取文件内容，默认以换行符作为分隔规则，非常适合处理按行读取文本的需求，同时也能通过自定义分隔函数适配更多读取场景。
bufio.Scanner基础使用流程
使用bufio.Scanner读取文本文件的核心步骤分为三步：打开文件、创建Scanner实例、循环扫描内容。首先需要通过os.Open打开目标文件，然后将文件句柄传入bufio.NewScanner创建扫描器，最后通过Scan方法循环读取内容，通过Text方法获取当前扫描到的文本。
以下是一个读取文本文件所有行并打印的基础示例：
package main
import (
"bufio"
"fmt"
"os"
)
func main() {
// 打开目标文本文件
file, err := os.Open("test.txt")
if err != nil {
fmt.Printf("打开文件失败: %vn", err)
return
}
// 函数退出前关闭文件，释放资源
defer file.Close()
// 创建bufio.Scanner实例，关联文件句柄
scanner := bufio.NewScanner(file)
// 循环扫描文件内容，默认按换行符分割
for scanner.Scan() {
// 获取当前扫描到的文本内容
line := scanner.Text()
fmt.Println(line)
}
// 检查扫描过程中是否出现错误
if err := scanner.Err(); err != nil {
fmt.Printf("扫描文件出错: %vn", err)
}
}
自定义分隔规则
bufio.Scanner默认使用换行符作为分隔符，如果需要按其他规则分割内容，可以通过Split方法自定义分隔函数。标准库已经提供了几种常用的分隔函数，比如bufio.ScanWords按单词分割、bufio.ScanRunes按Unicode字符分割，也可以自己实现分割逻辑。
以下是使用ScanWords按单词读取文件内容的示例：
package main
import (
"bufio"
"fmt"
"os"
"strings"
)
func main() {
// 这里使用字符串构造的读取器模拟文件内容，实际场景替换为os.Open打开的文件
content := "hello world go language bufio scanner"
scanner := bufio.NewScanner(strings.NewReader(content))
// 设置按单词分割
scanner.Split(bufio.ScanWords)
for scanner.Scan() {
fmt.Println(scanner.Text())
}
}
处理大文件与缓冲区调整
bufio.Scanner默认的初始缓冲区大小是4096字节，当扫描到的单段内容超过缓冲区大小时，Scanner会自动扩容，但如果单段内容非常大，可能会触发扩容失败的问题。此时可以通过Buffer方法手动设置初始缓冲区和最大缓冲区大小，避免读取大段内容时出现错误。
以下是调整缓冲区大小的示例：
package main
import (
"bufio"
"fmt"
"os"
)
func main() {
file, err := os.Open("large_content.txt")
if err != nil {
fmt.Printf("打开文件失败: %vn", err)
return
}
defer file.Close()
scanner := bufio.NewScanner(file)
// 设置初始缓冲区为64KB，最大缓冲区为1MB
buf := make([]byte, 64*1024)
scanner.Buffer(buf, 1024*1024)
for scanner.Scan() {
fmt.Println(scanner.Text())
}
}
常见注意事项
- 必须检查扫描错误：循环结束后一定要通过scanner.Err()检查是否有扫描错误，忽略错误可能会遗漏文件读取过程中的异常。
- Scan方法返回false的场景：除了文件读取完毕，扫描过程中出现错误也会返回false，因此不能仅凭返回false就认为文件已经读完。
- Text和Bytes方法的使用：Text方法返回字符串，Bytes方法返回字节切片，后者不会额外分配内存，适合对性能要求高的场景，但需要注意Bytes返回的切片在下次Scan调用后会被覆盖。
- 不要重复使用Scanner：一个Scanner实例只能关联一个输入流，如果需要读取多个文件，需要为每个文件创建新的Scanner实例。
适用场景总结
bufio.Scanner适合需要按行或者简单分隔规则读取文本内容的场景，尤其是处理大文件时，能够避免一次性加载整个文件到内存的问题。如果需要更复杂的文本解析（比如正则匹配、结构化解析），可以考虑使用bufio.Reader配合自定义的解析逻辑，或者第三方的文本解析库。合理选择工具能够让代码的效率和可维护性都得到提升。
Gobufio.Scanner文本文件读取高效IO修改时间：2026-07-07 02:09:20