本文介绍在 Go 中利用 regexp 包实现仅匹配并替换完整单词 products（如不匹配 products_list 中的 products），通过捕获组与边界断言组合，安全完成模板文本中的局部替换。
本文介绍在 go 中利用 `regexp` 包实现**仅匹配并替换完整单词 `products`**（如不匹配 `products_list` 中的 `products`），通过捕获组与边界断言组合，安全完成模板文本中的局部替换。
在 Go 的正则替换场景中，常见痛点是：直接使用 strings.ReplaceAll 或 re.ReplaceAllString("products", ".") 会无差别替换所有子串，导致 products_list 被错误改为 ._list，破坏原有语义。Go 标准库虽未提供类似 Python 的 re.sub() 配合回调函数的高级替换接口，但完全可通过带捕获组的正则 + 反向引用替换实现精准控制。
核心思路是：确保 products 前后均不紧邻下划线 _（即不是复合标识符的一部分），同时仍保持其为完整单词（\b 边界）。为此，我们采用如下正则模式：
package main
import (
"fmt"
"regexp"
)
func main() {
sample := `{% macro products_list(products) %}
{% for product in products %}
productsList
{% endfor %}
{% endmacro %}`
// 匹配：开头 / 非_字符 + 单词边界"products" + 非_字符 / 结尾
re := regexp.MustCompile(`(^|[^_])\bproducts\b([^_]|$)`)
result := re.ReplaceAllString(sample, `$1.$2`)
fmt.Println(result)
}
输出结果为：
{% macro products_list(.) %}
{% for product in . %}
productsList
{% endfor %}
{% endmacro %}
✅ 成功保留 products_list 中的 products 不被替换，仅替换了独立出现的 products（函数参数和 for 循环变量处）。
关键点解析：
- (^|[^_])：捕获组 1，匹配字符串开头或任意非 _ 字符（如空格、(、{、换行等）；
- \bproducts\b：严格匹配整个单词 products，\b 确保其前后为单词边界（非字母/数字/下划线）；
- ([^_]|$)：捕获组 2，匹配非 _ 字符或字符串结尾；
- $1.$2：替换时还原前后上下文字符，并将 products 替换为 . —— 这正是所需效果。
⚠️ 注意事项：
- 此方案依赖上下文字符判断，若 products 出现在 _products 或 products_ 中，将不会被匹配（符合预期）；
- 若需支持更复杂上下文（如 Unicode 字母、其他分隔符），可扩展 [^_] 为 (?
- 模板中若存在多处 products 且需差异化替换（如仅替换参数位置），应改用 re.ReplaceAllStringFunc + 自定义逻辑，或结合 FindAllStringIndex 手动处理。
综上，合理设计捕获组与边界条件，即可在 Go 中优雅实现“精准单词替换”，无需外部依赖，兼顾安全性与可维护性。
