
本文详解如何使用 bufio.Scanner 配合自定义终止符(如 Ctrl+])实现健壮的多行文本输入,支持空行、换行符保留及安全 EOF 处理,避免逐行阻塞或截断问题。
本文详解如何使用 `bufio.scanner` 配合自定义终止符(如 ctrl+])实现健壮的多行文本输入,支持空行、换行符保留及安全 eof 处理,避免逐行阻塞或截断问题。
在 Go 编写的命令行工具中,接收用户输入的多行文本(例如配置片段、代码块或带空行的段落)是一个常见但易出错的需求。初学者常误用 ReadString('\n') 或 ReadLine(),导致粘包、换行丢失、空行被跳过,甚至无限循环——正如原始代码所示:每次调用仅读取一行,却在循环中反复新建 bufio.Reader,造成输入流错位与缓冲混乱。
真正可靠的方式是复用一个 bufio.Scanner 实例,并在应用层定义多行输入的边界语义。推荐采用“显式终止符”策略:用户输入特定控制字符(如 ASCII Group Separator \x1D,对应快捷键 Ctrl+])表示当前多行输入结束。该方案兼具可预测性、跨平台兼容性(终端普遍支持)和对空行的天然支持。
以下为生产就绪的实现:
package main
import (
"bufio"
"fmt"
"os"
)
func main() {
scn := bufio.NewScanner(os.Stdin)
for {
fmt.Println("Enter Lines (press Ctrl+] on empty line to finish):")
var lines []string
for scn.Scan() {
line := scn.Text()
// 检查是否为单独的 Ctrl+](ASCII 0x1D)
if len(line) == 0 {
// 空行后立即检查下一次输入是否为 Ctrl+]
// 但 Scanner 默认跳过空白行,故改用更鲁棒方式:允许用户在空行输入 ^]
// 实际中我们约定:在任意行(含空行)输入 ^] 即终止
// 因此需读取原始字节以捕获 \x1D —— 但 Scanner 不暴露底层 Reader
// ✅ 替代方案:检测单字符行是否为 \x1D(用户输入 ^] 后回车 → 行内容为 "\x1D")
}
// 更佳实践:统一用字节扫描器处理控制符,但为简洁与兼容性,
// 我们采用「用户在新行输入 ^]」约定,并接受其作为唯一终止信号
if len(line) == 1 && line[0] == '\x1D' {
break
}
lines = append(lines, line)
}
// 处理 Scanner 错误(如 I/O 中断)
if err := scn.Err(); err != nil {
fmt.Fprintln(os.Stderr, "Input error:", err)
break
}
// 输出结果(保留原始换行与空行)
if len(lines) > 0 {
fmt.Println("\nResult:")
for _, l := range lines {
fmt.Println(l)
}
fmt.Println()
} else {
// 用户直接输入 ^] 且无前置内容,视为退出整个程序
fmt.Println("No input provided. Exiting.")
break
}
}
}✅ 关键设计说明:
- 不新建 Scanner:bufio.Scanner 内部已高效管理缓冲区,循环外初始化一次即可,避免资源泄漏与状态错乱。
- 终止逻辑清晰:仅当某行为单个 \x1D 字符时中断内层循环,其余所有行(包括空行 " "、"")均原样追加至 lines 切片。
- 空行完全保留:scn.Text() 返回的是不含 \n 的纯字符串,但空行会返回 "",因此 append(lines, line) 自然保留了段落结构。
- 错误防御:显式检查 scn.Err(),捕获 EOF、interrupt 等系统级错误,防止 panic。
? 使用提示:
- 在 macOS/Linux 终端:输入文字后,按 Ctrl+V 再按 Ctrl+] 可插入 ^];或直接按 Ctrl+] + Enter。
- 在 Windows PowerShell:Ctrl+] 通常有效;若无效,可临时改用 ---END--- 等字符串作为终止标记(只需将 line == "---END---" 替换判断逻辑)。
- 如需支持“连续粘贴含多空行文本”,本方案开箱即用——因为每行独立判断,空行不会触发提前终止。
最后,请勿使用 fmt.Scanf("%s") 或 os.Stdin.Read() 手动解析换行:它们缺乏高层抽象,极易因缓冲区大小、编码、CRLF/LF 差异引入 bug。坚持使用 bufio.Scanner + 显式协议,是构建稳定 CLI 应用的基石。










