gofmt 本身不支持通配符（如 <wildcard>）或正则匹配的重写规则，其 -r 参数仅接受固定模式的 AST 级结构替换；但可通过组合 shell 命令遍历包目录，并对每个 Go 文件执行精准的 gofmt -r 替换，实现前缀级批量导入路径迁移。
gofmt 本身不支持通配符（如 `
gofmt -r 的设计目标是语法树（AST）层面的安全重构，而非字符串级别的模糊替换。这意味着它要求重写规则必须是有效的 Go 语法片段，且左右两侧需保持结构等价性——例如 time.Now() -> time.Now().UTC() 是合法的，但 github.com/old/repo/* -> github.com/new/repo/* 因含非法通配符且非有效表达式，会直接报错。
不过，针对“将所有以 github.com/some/path/ 开头的导入路径统一替换为 someotherrepo.com/some/path/”这一典型迁移需求，可采用以下可靠方案：
✅ 推荐做法：递归遍历 + 单文件精准重写
利用 gofmt 对目录的递归支持，结合 find 或 glob 定位 .go 文件，并为每个文件执行确定性重写：
# Linux/macOS：递归处理所有 .go 文件，安全替换 import 路径前缀
find ./ -name "*.go" -exec gofmt -w -r '"github.com/some/path/a" -> "someotherrepo.com/some/path/a"' {} \;⚠️ 注意：-r 中的引号必须为双引号（Go 字符串字面量），且需指定一个真实存在的子路径占位符（如 a、v1、internal 等），因为 gofmt 不接受空或通配模式。只要该占位符在目标文件中实际出现过（例如某文件含 import "github.com/some/path/v1"），规则即生效；若未匹配，则跳过，无副作用。
更健壮的方式是使用多个常见子路径覆盖大多数情况：
for pkg in a v1 v2 internal client server; do
find ./ -name "*.go" -exec gofmt -w -r "\"github.com/some/path/$pkg\" -> \"someotherrepo.com/some/path/$pkg\"" {} \;
done⚠️ 重要限制与注意事项
- ❌ gofmt -r 不支持正则、通配符、捕获组或动态变量 —— 它不是 sed，而是基于 AST 的语义重写工具；
- ✅ 替换必须保持 Go 语法有效性：左侧须是完整、可解析的 Go 表达式或声明（如 "import path"、func(x int) int { return x }）；
- ? gofmt -r 默认只作用于匹配到的 AST 节点，不会修改其他代码；建议先用 -d（diff 模式）预览变更：
gofmt -d -r '"github.com/some/path/v1" -> "someotherrepo.com/some/path/v1"' main.go
- ?️ 生产环境务必配合 Git 提交前检查：git status + git diff 确认变更范围，避免误替换注释或字符串字面量（gofmt 默认忽略字符串内容，仅处理语法结构）。
✅ 替代方案（如需更强灵活性）
当导入路径变体极多（如 .../path/x, .../path/y/z, .../path/internal/util）且无法枚举时，推荐使用专用工具：
- gorename（适用于符号重命名，不适用导入路径）；
-
go-mod-upgrade 或 go get -u 配合 go.mod 替换指令（推荐用于模块级迁移）：
go mod edit -replace github.com/some/path=someotherrepo.com/some/path@v0.0.0 go mod tidy
- 或编写轻量 Go 脚本，用 go/parser + go/ast 实现自定义 AST 导入节点遍历与替换（适合复杂场景）。
总之，gofmt 是可靠的格式化与简单重构工具，但不应被当作通用文本处理器。理解其 AST 本质，结合 shell 自动化与模块化工具链，才能高效、安全地完成大规模 Go 代码迁移任务。
