Go regexp.Regexp MatchReader 怎样匹配流式文本输入

如果文本来自文件、网络连接或其他只能逐步读取的来源，不必先把全部内容拼成一个字符串。Go 的 regexp.Regexp.MatchReader 接收 io.RuneReader，返回一个布尔值，适合回答“这段输入里是否出现过匹配”这个问题。

最常用的组合是：先用 regexp.Compile 得到可复用的正则对象，再把实现了 ReadRune 的 Reader 传给 MatchReader。它只告诉你是否匹配，不返回位置、子匹配或读取错误；需要更细的结果时，应改用对应的 FindReaderIndex 或自己设计错误处理。

MatchReader 适合解决什么输入问题

MatchString 面向已经存在的字符串，Match 面向字节切片，而 MatchReader 面向 io.RuneReader。这个接口的关键不是“把正则变成流式算法”这么宽泛，而是让正则匹配器从 Reader 读取 rune，不要求调用方先准备完整字符串。

Go 官方文档把它定义为判断 Reader 返回的文本是否包含匹配。对于一次性判断，调用编译后的对象更直观：

package main

import (
	"bufio"
	"fmt"
	"strings"
	"regexp"
)

func main() {
	// 先编译一次正则，后续可以复用同一个 Regexp 对象。
	re := regexp.MustCompile(`order-[0-9]+`)

	// strings.Reader 实现了 ReadRune，可作为 io.RuneReader 传入。
	reader := bufio.NewReader(strings.NewReader("header order-2048 tail"))
	found := re.MatchReader(reader)
	fmt.Println(found)
}

这里的结果是 true。bufio.Reader 不是必须的，因为 strings.Reader 本身已经能读 rune；它更适合作为“真实输入会先经过缓冲适配”的示例。真正读取文件或网络数据时，可以把相应的字节 Reader 包在 bufio.NewReader 外面。

两种入口的错误边界不同

如果正则表达式来自配置文件或用户输入，不要用 MustCompile 把编译错误变成 panic。包级函数 regexp.MatchReader(pattern, reader) 会返回 (bool, error)，适合一次性完成编译和匹配；已经编译好的 Regexp.MatchReader(reader) 只返回 bool，因为编译错误已经在前一步处理过了。

package main

import (
	"fmt"
	"regexp"
	"strings"
)

func main() {
	// pattern 可能来自配置，因此保留 Compile 的错误返回。
	pattern := `user-[0-9]+`
	reader := strings.NewReader("user-42")

	matched, err := regexp.MatchReader(pattern, reader)
	if err != nil {
		// 正则语法错误属于编译阶段错误，不要当成“未匹配”。
		fmt.Println("compile error:", err)
		return
	}
	fmt.Println("matched:", matched)
}

这段代码把两个结果分开：err != nil 说明模式无法编译；err == nil 时，matched == false 才表示输入中没有找到匹配。若模式会被多次使用，更建议显式调用 regexp.Compile，缓存 *regexp.Regexp，再反复调用对象方法。

Reader 的生命周期要单独考虑

MatchReader 接收的是一个读取接口，不是可重复索引的字符串。调用后不要假设 Reader 还停在起点；如果同一段输入要用两个正则检查，应为每次检查准备新的 Reader，或者在更上层保存可重新生成输入的来源。

还要注意接口类型：io.Reader 只有 Read([]byte)，而 MatchReader 要求的是 io.RuneReader。文件、网络等字节流通常需要经过 bufio.NewReader 才能提供 ReadRune。如果输入本身不是合法 UTF-8，读取与解码边界也应由 Reader 和上层协议明确处理，不能把 MatchReader 的 false 当成完整编码校验结果。

什么时候不要用 MatchReader

需要匹配位置时，用 FindReaderIndex；需要捕获组时，用 FindReaderSubmatchIndex；需要把错误位置映射回原始字节时，还要额外维护输入偏移。MatchReader 的返回值只有一个布尔量，优点是调用面小，代价是它不会告诉你“在哪里匹配”以及“Reader 读取阶段发生了什么”。

可以把选择记成三句话：

• 只问是否命中：编译后的 Regexp.MatchReader 足够。
• 模式也需要现场编译：使用包级 regexp.MatchReader 并检查 error。
• 需要位置或捕获组：换用 Reader 版查找方法，不要从 bool 结果倒推细节。

常见问题

MatchReader 和 MatchString 有什么区别？

两者都只返回是否匹配，但输入来源不同：前者从 io.RuneReader 读取，后者接收已经存在的字符串。

为什么 regexp.MatchReader 有 error 而 Regexp.MatchReader 没有？

前者内部还要编译 pattern，可能遇到语法错误；后者调用的是已经成功编译的 *Regexp，所以只返回匹配结果。

可以用普通 io.Reader 直接调用吗？

不可以。请使用实现 ReadRune 的类型，例如 bufio.Reader 或 strings.Reader，再传给 MatchReader。