gofmt 的 -r 重写功能基于 Go 表达式模式匹配，单字母小写标识符（如 h）会被视为通配符匹配任意子表达式，而非简单文本替换——这是其设计本意，而非 bug。
gofmt 的 `-r` 重写功能基于 go 表达式模式匹配，单字母小写标识符（如 `h`）会被视为通配符匹配任意子表达式，而非简单文本替换——这是其设计本意，而非 bug。
gofmt -r 并非通用文本查找替换工具，而是语法树层面的结构化重写器。它将源码解析为抽象语法树（AST），在 AST 节点上按 Go 表达式语法规则进行模式匹配。根据 官方文档：
“模式（pattern）和替换（replacement）都必须是合法的 Go 表达式。在模式中，单字符小写字母标识符（如
x,h）作为通配符，匹配任意子表达式；这些匹配到的子表达式，会在替换中以相同标识符代入。”
这意味着 gofmt -r 'h -> H' 中的 h 不代表字符 'h'，而是一个占位符——它会匹配所有可被解析为 Go 表达式的节点，包括：
- 包名（
main→ 替换为H） - 函数名（
main→H） - 函数体内的裸语句（
fmt.Printf(...)→ 简化为H，因fmt.Printf是调用表达式，被整体匹配并替换成H） - 参数、操作数、甚至空语句位置（见扩展示例中的
a,b,int,+,*全部坍缩为H）
✅ 正确用法示例：若想将函数名 main 重命名为 Main，应使用精确的语法结构模式：
<code class="bash">gofmt -r 'func main() $*_-> func Main() $*_' -w hello.go</code>
其中 $*_ 是特殊语法，表示“匹配零个或多个语句”，确保函数签名和函数体被完整保留，仅改名。
⚠️ 注意事项：
- 避免单字母模式（如
'x -> Y'），极易引发全局误匹配； - 模式必须是合法 Go 代码片段（例如
'fmt.Printf($*_) -> log.Println($*_)'合法；'printf -> println'非法）； - 建议先用
-d查看差异，再加-w写入：gofmt -r '...' -d hello.go； - 复杂重构推荐使用
gorename或现代 IDE 的语义重命名功能，它们基于类型信息，安全可靠。
总结：gofmt -r 是强大但高危的工具——它精准，也危险。理解其 AST 匹配本质，善用结构化模式（而非字符串思维），才能真正驾驭它。
