本文详解 Go 语言中 bufio.Scanner 的终止机制，重点介绍通过操作系统级 EOF 信号（如 Ctrl+Z / Ctrl+D）主动退出扫描循环的正确方法，并提供可中断、可复用的实践方案。
本文详解 go 语言中 `bufio.scanner` 的终止机制，重点介绍通过操作系统级 eof 信号（如 ctrl+z / ctrl+d）主动退出扫描循环的正确方法，并提供可中断、可复用的实践方案。
bufio.Scanner 本身不提供显式的“停止”或“取消”接口——它设计为流式、阻塞式、基于 EOF 或错误自动终止的扫描器。因此，“停止扫描”本质上是向输入源发送 EOF（End-of-File）信号，让 scanner.Scan() 返回 false 并结束循环。
✅ 正确终止方式：触发 EOF
在交互式终端（如 os.Stdin）中，用户可通过以下组合键发送 EOF：
- Windows：按 Ctrl + Z 后回车（即输入 ^Z）
- macOS/Linux：按 Ctrl + D（无需回车）
此时 scanner.Scan() 返回 false，循环自然退出，且 scanner.Err() 可能返回 io.EOF（非错误，属正常终止）。
package main
import (
"bufio"
"fmt"
"os"
)
func main() {
fmt.Println("请输入文本（按 Ctrl+Z (Win) 或 Ctrl+D (macOS/Linux) 结束输入）：")
scanner := bufio.NewScanner(os.Stdin)
lines := []string{}
for scanner.Scan() {
line := scanner.Text()
lines = append(lines, line)
fmt.Printf("已读入：%q\n", line)
}
// 检查是否因真实错误退出（非 EOF）
if err := scanner.Err(); err != nil && err != io.EOF {
fmt.Fprintf(os.Stderr, "扫描错误：%v\n", err)
os.Exit(1)
}
fmt.Printf("\n共读取 %d 行。\n", len(lines))
}⚠️ 注意：scanner.Err() 在 Scan() 返回 false 后才可靠；若仅需区分正常结束与异常，应检查 err == io.EOF（表示用户主动终止），而非将 io.EOF 视为错误处理。
❌ 常见误区与替代方案
- 不要用 break 强制跳出：虽可退出循环，但未消耗缓冲区剩余数据，且无法释放底层资源（对 io.MultiReader 等复合 Reader 尤其重要）。
- 避免无超时阻塞：若输入源可能长期无响应（如网络 Reader），应结合 context.WithTimeout 封装 Reader，或改用 bufio.Reader.ReadLine() 配合手动 EOF 判断。
-
io.MultiReader 场景特别注意：你示例中的 io.MultiReader(outReader, errReader) 通常用于合并 stdout/stderr 输出。此类 Reader 不会因单个子 Reader EOF 而整体 EOF——只有所有子 Reader 均耗尽才会返回 EOF。因此，若 outReader 已关闭但 errReader 仍在写入，scanner.Scan() 会持续阻塞。此时更推荐：
- 使用 io.Pipe 或 chan string 进行协程安全的多路复用；
- 或改用 io.ReadCloser + bufio.Reader + ReadString('\n') 并主动监听 io.EOF。
✅ 推荐健壮模式：带上下文与错误分类的扫描
func scanWithTimeout(reader io.Reader, timeout time.Duration) ([]string, error) {
ctx, cancel := context.WithTimeout(context.Background(), timeout)
defer cancel()
// 包装 reader 支持 context 取消（需自定义或使用第三方库如 golang.org/x/net/context）
// 简化版：用 goroutine + channel 模拟可取消扫描
ch := make(chan struct {
line string
err error
}, 100)
go func() {
defer close(ch)
scanner := bufio.NewScanner(reader)
for scanner.Scan() {
select {
case ch <- struct{ line string; err error }{scanner.Text(), nil}:
case <-ctx.Done():
return
}
}
if err := scanner.Err(); err != nil && err != io.EOF {
ch <- struct{ line string; err error }{"", err}
}
}()
var lines []string
for res := range ch {
if res.err != nil {
return nil, res.err
}
lines = append(lines, res.line)
}
return lines, nil
}总结：bufio.Scanner 的“停止”本质是输入流的优雅关闭。掌握 EOF 触发机制、正确处理 scanner.Err()、并根据场景选择 MultiReader 替代方案，是编写稳定 I/O 程序的关键。
