当前位置：首页 > 文章列表 > Golang > Go教程 > Go regexp.Expand 如何把捕获组写入缓冲区

Go regexp.Expand 如何把捕获组写入缓冲区

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

我第一次用 regexp.Expand 时，卡住的地方不是正则本身，而是把“捕获到的文本”和“捕获文本在原字符串中的位置”混在了一起。这个方法接收的不是 []string，而是 FindSubmatchIndex 产生的字节偏移切片。把这条关系理顺后，模板替换就很直接：先找匹配，再让 Expand 把 $key、$1 等变量追加进已有缓冲区。

要点速览

match 必须来自 FindSubmatchIndex 或对应的 All 方法，偏移按“起点、终点”成对排列。
Expand 只追加模板结果，不会自动把原文中未匹配的部分复制到输出。
循环中要接住每次返回的 []byte；模板中的 $1x 要确认是组名还是数字组加后缀。

regexp.Expand 的四个输入先对齐

Expand(dst, template, src, match) 可以理解成一台“按索引取片段的模板拼接器”。src 是原始字节，match 告诉它每个匹配组在 src 中的起止位置，template 决定输出顺序，dst 则是承接结果的缓冲区。它返回追加后的切片，所以可以在多次匹配之间复用同一个结果。

Go regexp.Expand 的模板、原文、捕获组索引和输出缓冲区静态关系说明图 — 图1：regexp.Expand 输入关系说明图，展示模板变量如何通过 match 索引从 src 取出片段并追加到 dst；这是静态结构图，不是运行截图。

下面这段代码把一行 key: value 转成 key=value。代码没有直接读取捕获文本，而是把索引交给 ExpandString：

package main

import (
    "fmt"
    "regexp"
)

func main() {
    // 命名捕获组让模板中的 $key、$value 更容易阅读。
    re := regexp.MustCompile(`(?m)(?P\w+):\s+(?P\w+)$`)
    src := "port: 8080\nmode: safe\n"
    result := make([]byte, 0, len(src))

    // 每个 match 都包含完整匹配和各捕获组的字节起止位置。
    for _, match := range re.FindAllStringSubmatchIndex(src, -1) {
        // 返回值要重新赋给 result，才能保留此前匹配追加的内容。
        result = re.ExpandString(result, "$key=$value\n", src, match)
    }
    fmt.Print(string(result))
}

这里的 dst 初始容量只是一个可选的分配提示，不改变替换语义。若使用字节输入，就把原文、模板和方法换成 []byte 版本的 Expand。

FindSubmatchIndex 返回的不是文本，而是偏移对

假设正则是 (?P\w+):\s+(?P\w+)，一次匹配的索引数组会按下面的顺序排列：

位置	含义	取值方式
0、1	完整匹配	`src[match[0]:match[1]]`
2、3	第 1 个捕获组 key	`src[match[2]:match[3]]`
4、5	第 2 个捕获组 value	`src[match[4]:match[5]]`

这也解释了为什么不能把 FindStringSubmatch 的结果直接传给 Expand：前者给的是字符串列表，后者需要的是每一组在原始输入中的字节位置。捕获组没有匹配到时，对应位置可能是负数，Expand 会把这个变量当成空片段处理，而不是主动报错。

Go regexp.Expand 数字组命名组与未匹配组的模板边界静态关系说明图 — 图2：模板变量边界说明图，区分数字组、命名组、字面美元符号和未匹配组的输出关系；这是静态结构图，不是运行截图。

模板变量的三个容易误判的边界

数字组可以写成 $1，命名组可以写成 $key 或 ${key}。当变量后面紧跟字母、数字或下划线时，解析器会尽可能把它们一起当作名字。因此 $1x 会优先按名为 1x 的组解析，不等于“第 1 组加字母 x”；需要后缀时写成 ${1}x。如果要输出字面量美元符号，用 $$。

实际使用中我更偏向命名组：正则改动捕获组顺序后，$key 仍然表达原来的意图。数字组适合很短的临时模板，但要把模板和正则放在同一处，避免后续维护者猜索引。