正则匹配

来源：17golang原创 2026-11-11 17:17:15 0浏览收藏

Go 的 regexp.Compile 成功，只说明模式语法能够解析，不代表当前输入一定命中。re.MatchString(input) 返回的是 bool，不会返回空字符串；如果日志显示“结果为空”，应先确认是不是读取了 FindString 的结果，或者在业务封装里把 false 转成了空值。

我会先将问题拆成模式、输入、接口返回值三件事，再动正则本身。否则很容易为了让样本“通过”而删除必要的约束，最后把错误输入也放进业务系统。

官方文档：https://pkg.go.dev/regexp

先确定日志里的空值来自哪个接口

调用方式	返回值	怎样理解
regexp.Compile(pattern)	正则对象与 error	判断表达式能否编译
re.MatchString(input)	bool	判断输入中是否存在匹配
regexp.MatchString(pattern, input)	bool 与 error	既要处理语法错误，也要处理不匹配
re.FindString(input)	string	取匹配文本；空值有歧义
re.FindStringIndex(input)	字节区间或 nil	区分无匹配与空匹配

如果调用的是编译后对象的方法，记录 matched=false 比“正则结果为空”更明确。配置错误则保留为 error，不能把编译失败也归入普通的不匹配。这是我更愿意保留的区分：配置有问题与业务输入不符合规则，需要不同处理。

模式与编译接口、输入与两类匹配接口之间的静态关系 — 图1：接口关系结构说明图。编译对象不等于命中结果，存在性判断和文本提取承担不同职责；连线不表示执行时序。

把模式和输入的真实内容保留下来

眼睛看见的 AB-204，实际可能是带换行的字符串。下面用一个编号规则展示诊断方法；这段代码是读者可自行运行的原创样例，本文不把它描述为已执行结果。

package main

import (
    "fmt"
    "regexp"
)

func main() {
    pattern := `\A[A-Z]{2}-[0-9]{3}\z`
    input := "AB-204\n" // 故意保留换行，展示肉眼不可见的输入差异。
    re, err := regexp.Compile(pattern)
    if err != nil {
        fmt.Printf("正则编译失败: %v\n", err)
        return // 配置错误不能当作普通业务不匹配。
    }
    // 此处只有人为构造的样本；真实业务不要直接打印敏感内容。
    fmt.Printf("pattern=%q input=%q bytes=%d\n", re.String(), input, len(input))
    matched := re.MatchString(input)
    index := re.FindStringIndex(input)
    fmt.Printf("matched=%t index=%v\n", matched, index)
}

这个模式限定两个大写英文字母、连接符和三位数字，并限制整串范围。样例末尾的换行不属于编号，所以按规则应不匹配。应先确认数据协议：如果换行是传输分隔符，就在对应读取层移除它；如果编号字段本来不允许换行，就拒绝输入。不要无条件 TrimSpace 来掩盖上游问题。

还要区分 Go 字符串和正则转义两层语义。反引号原始字符串 `\d+` 与双引号字符串 "\\d+" 才能把相同的正则反斜杠传进去。若模式来自 JSON 配置，还应看解码后的字符串，而不是只看配置文件的展示形式。

区分没有命中和零长度命中

FindString 返回空字符串时，可能完全没有命中，也可能确实命中了一个零长度区间。我更倾向于在诊断中用位置接口把两者拆开，避免在业务封装里丢失信息。

// 片段放在 main 内，沿用前例的 fmt 和 regexp 导入。
re, err := regexp.Compile(`[0-9]*`)
if err != nil {
    fmt.Printf("正则编译失败: %v\n", err)
    return
}
input := "word"
loc := re.FindStringIndex(input)
switch {
case loc == nil:
    fmt.Println("没有匹配")
case loc[0] == loc[1]:
    // 位置存在但区间长度为零，不能误报成没有匹配。
    fmt.Printf("零长度匹配，字节位置=%d\n", loc[0])
default:
    fmt.Printf("匹配文本=%q\n", input[loc[0]:loc[1]])
}

这里 [0-9]* 允许零个数字，因此 word 开头可以出现零长度命中；这并不是 Compile 的故障。如果业务要求至少一位数字，应根据需求使用 [0-9]+，并进一步决定是否需要整串约束。索引值是字节偏移，处理中文时不能直接当作字符数量。