Go 的正则表达式不支持条件替换，但可通过双阶段替换或自定义解析逻辑优雅处理含可选组的模板转换，避免生成冗余空属性（如 class=""）。
go 的正则表达式不支持条件替换，但可通过双阶段替换或自定义解析逻辑优雅处理含可选组的模板转换，避免生成冗余空属性（如 class=""）。
在 Go 中进行模板语法迁移（例如从 Jekyll 风格 {% img right /images/testing %} 转为 Hugo 的 {{}}）时，常需匹配可选的修饰符（如对齐类名 right），并在其缺失时不输出 class="..." 字段。遗憾的是，Go 标准库的 regexp.ReplaceAllString 等函数不支持条件逻辑——无法在替换字符串中动态决定是否包含 class="$1" 片段。
✅ 推荐方案一：两阶段正则替换（简洁可靠）
适用于规则简单、可选字段种类少的场景。核心思路是优先匹配无修饰符的模式，再匹配带修饰符的模式，从而避免空 class=""：
package main
import (
"fmt"
"regexp"
)
func main() {
txt := `{% img right /images/testing %}
{% img /images/blank.png %}`
// Step 1: 替换无 class 的情况（优先匹配，防止被下一步误捕）
reNoClass := regexp.MustCompile(`{%\s*img\s+([/\w.-]+)\s+%}`)
txt = reNoClass.ReplaceAllString(txt, "{{< figure src=\"$1\" >}}")
// Step 2: 替换带 class 的情况（注意：\s+ 确保 class 值非空）
reWithClass := regexp.MustCompile(`{%\s*img\s+(\p{L}+)\s+([/\w.-]+)\s+%}`)
txt = reWithClass.ReplaceAllString(txt, "{{< figure class=\"$1\" src=\"$2\" >}}")
fmt.Println(txt)
}输出：
{{< figure class="right" src="/images/testing" >}}
{{< figure src="/images/blank.png" >}}⚠️ 注意事项：
- 顺序至关重要：必须先处理无修饰符的情况，否则带修饰符的正则可能错误匹配到无修饰符行（因
\s*可匹配零宽空格，导致空捕获）。- 正则中
([/\w.-]+)比原题的[/\S]+更安全，避免匹配换行或控制字符；\p{L}+确保 class 值为非空字母（排除空格或空字符串）。- 若需支持更多修饰符（如
left,center,shadow），仍可用此模式扩展，无需修改架构。
✅ 推荐方案二：手动解析 + 回调函数（高效灵活）
当性能敏感或规则复杂（如嵌套、多可选字段、上下文依赖）时，建议放弃纯正则，改用 FindAllSubmatchIndex 手动提取并按需格式化：
import (
"bytes"
"regexp"
)
var p = regexp.MustCompile(`{%\s*img\s*(\p{L}*)\s+([/\w.-]+)\s+%}`)
func transformImg(src []byte) []byte {
dst := bytes.NewBuffer(nil)
last := 0
for _, m := range p.FindAllSubmatchIndex(src, -1) {
// 复制上一匹配前的原文
dst.Write(src[last:m[0][0]])
// 提取分组：group1=class, group2=src
class := string(src[m[0][2]:m[0][3]])
srcPath := string(src[m[0][4]:m[0][5]])
// 条件构建结果
if class != "" {
dst.WriteString(fmt.Sprintf(`{{< figure class="%s" src="%s" >}}`, class, srcPath))
} else {
dst.WriteString(fmt.Sprintf(`{{< figure src="%s" >}}`, srcPath))
}
last = m[0][1]
}
dst.Write(src[last:])
return dst.Bytes()
}该方式仅遍历源文本一次，且逻辑完全可控，便于后续扩展（如校验路径合法性、添加默认 class、日志记录等）。
总结
- Go 正则引擎无条件替换能力，切勿尝试在
$1占位符中嵌入逻辑。 - 双阶段替换是多数场景的黄金解法：清晰、易维护、符合 Go 的务实哲学。
- 当需极致性能或复杂语义时，转向显式解析——用正则定位，用代码决策，这才是 Go 处理文本转换的惯用范式。
