gofmt 的 -r 重写功能基于 go 表达式模式匹配，单字符小写字母（如 h）会被视为通配符匹配任意子表达式，而非文本替换；错误使用会导致整个 ast 被误替换，需用结构化模式精准约束。

gofmt 的 -r 重写功能基于 go 表达式模式匹配，单字符小写字母（如 h）会被视为通配符匹配任意子表达式，而非文本替换；错误使用会导致整个 ast 被误替换，需用结构化模式精准约束。

gofmt -r 并非字符串查找替换工具，而是抽象语法树（AST）级别的结构化重写器。其核心规则在 官方文档 中明确说明：

Both pattern and replacement must be valid Go expressions. In the pattern, single-character lowercase identifiers serve as wildcards matching arbitrary sub-expressions; those expressions will be substituted for the same identifiers in the replacement.

这意味着 h 不代表字母 "h"，而是一个万能占位符——它会匹配 package main 中的 main、函数名 main、甚至 fmt.Printf 中的任意标识符或字面量。你执行的命令：

gofmt -r 'h -> H' -w hello.go

实际效果是：所有可被解析为“表达式”的节点（包括包名、函数名、函数体语句等）都被替换为字面量 H，因此得到：

package H

import "fmt"

func H() {
 H
}

这完全符合设计预期，但显然不是文本编辑意图。

✅ 正确做法：使用具名、结构化的 Go 表达式模式，明确限定匹配范围。例如，若想将所有名为 main 的函数重命名为 Main，应写为：

gofmt -r 'func main() $* -> func Main() $*' -w hello.go

其中 $* 是特殊通配符，表示“零个或多个语句”，而 main() 是精确的函数签名模式，仅匹配函数声明本身。

⚠️ 注意事项：

• 避免使用单字符小写标识符（如 x, f, h）作为模式，除非你明确需要匹配任意子表达式；
• 模式和替换都必须是语法合法的 Go 代码，否则 gofmt 报错退出；
• -r 修改的是 AST 节点，不是源码字符串——无法用于修改注释、空白符或字符串字面量内容；
• 复杂重写建议先用 -d（显示差异）预览，再加 -w 写入文件。

? 小结：gofmt -r 是强大但高危的重构工具，适用于符合 Go 语法结构的语义化变换（如接口方法签名调整、错误检查模式统一），绝不适用于简单文本替换。如需文本级替换，请使用 sed、perl 或 IDE 的正则替换功能。