Go regexp用 QuoteMeta 转义用户输入模式的实现方法

当正则表达式的一部分来自搜索框、路径参数或配置文件时，用户输入里的 .、+、?、括号和方括号都会被 regexp 当成语法。要让这段输入只代表“原样出现的文字”，先调用 regexp.QuoteMeta，再把返回值放进固定正则。它会转义正则元字符，得到的结果仍是正则表达式，但匹配含义已经变成字面文本。

Go regexp 的 QuoteMeta 先把动态输入变成字面片段

regexp.QuoteMeta(s) 接收一个字符串并返回转义后的字符串。比如输入 Go.+(dev)?，返回值会把点号、加号、括号和问号前置反斜杠。之后把它交给 regexp.Compile 或 regexp.MatchString，这些符号就按普通字符参与匹配，而不是“任意字符”“重复一次或多次”或“可选分组”。

package main

import (
	"fmt"
	"regexp"
)

func main() {
	input := `Go.+(dev)?`
	quoted := regexp.QuoteMeta(input)

	// 只把输入当作字面文本，避免元字符改变匹配范围。
	re, err := regexp.Compile("^" + quoted + "$")
	if err != nil {
		// 动态组合仍应检查 Compile 错误，便于发现固定片段的配置问题。
		panic(err)
	}
	fmt.Println(quoted)
	fmt.Println(re.MatchString(input))
}

这里的两个判断点很明确：返回的正则片段应包含转义符，完整匹配时用 ^ 和 $ 限定整段文本；如果只调用 MatchString 而不加边界，目标字符串中只要出现这段字面片段就会返回成功。

固定正则与动态字面片段要分开拼接

实际搜索往往不是“整串完全相等”，而是固定语义加一段可变关键词。例如固定前缀是 ^error:，关键词来自输入框，固定后缀是行尾。正确做法是只对关键词调用 QuoteMeta，固定语法继续由开发者控制。

package main

import (
	"fmt"
	"regexp"
)

func hasErrorLine(keyword, text string) (bool, error) {
	// 固定前缀和行尾是业务规则，用户关键词只保留字面含义。
	pattern := `^error:\s+` + regexp.QuoteMeta(keyword) + `$`
	re, err := regexp.Compile(pattern)
	if err != nil {
		return false, err
	}
	// MatchString 判断整行文本是否符合已组合的表达式。
	return re.MatchString(text), nil
}

func main() {
	ok, err := hasErrorLine("disk.+", "error: disk.+")
	// 这里的加号和点号属于关键词本身，不会扩展成正则通配语义。
	fmt.Println(ok, err)
}

如果把关键词直接拼到表达式里，disk.+ 可能匹配 disk-full；经过 QuoteMeta 后，它只匹配包含连续字符 disk.+ 的行。这样既保留了固定规则的可读性，也把不可信的动态片段隔离在明确边界内。

迁移时要检查空输入、大小写与替换边界

从手写字符串拼接迁移到 QuoteMeta，可以按下面的清单检查。空字符串经过 QuoteMeta 仍是空字符串，所以表达式是否会变成“匹配任意位置”取决于固定部分；搜索接口通常应先决定空关键词是返回全部、返回空结果，还是直接拒绝。

还要区分“用户输入是字面搜索词”和“用户输入本来就是正则”这两种产品需求。前者应该统一 QuoteMeta；后者则要明确告知用户支持 RE2 语法，并用 Compile 返回错误，而不是把两种模式混在同一个字段里。

常见问题

QuoteMeta 会把所有字符都加反斜杠吗？

不会。它针对正则元字符进行转义，普通字母、数字和大多数普通文本不会被无意义改写。

QuoteMeta 能防止正则造成的所有问题吗？

它只解决动态文本改变正则语义的问题。输入长度、空值策略、匹配范围和业务限流仍需由调用方处理。

固定正则也应该先 QuoteMeta 吗？

不应该。固定片段中的边界、分组和字符类可能就是设计好的正则语义；只转义来自用户或外部配置的字面片段。

把动态输入先转换为字面片段，再与固定正则组合，是 Go 中最小且清晰的实现方式。关键不在于记住一张元字符清单，而在于始终区分“表达式语法”和“要被搜索的文本”。