用途:把过时的 Go 写法替换为现代等价实现,使代码库持续跟进近约三个 Go 版本的语言特性与标准库改进,并优先保证安全与正确性,其次可读性,最后逐步优化。
主要能力:检查 go.mod / go.work 确定当前 Go 版本,提示升级;读取项目根目录 .modernize 文件,避免重复已忽略的建议;扫描代码库中的现代化机会;在可用时运行带 modernize linter 的 golangci-lint 与 go test ./...;按迁移优先级指南整理结果。覆盖方向包括已弃用包与 API 替换(如 math/rand 到 math/rand/v2、reflect.PtrTo 到 PointerTo)、语言特性(range over int、min/max、any、迭代器)、标准库升级(slices、maps、cmp、slog)、测试模式(t.Context、b.Loop、synctest)以及工具与基础设施(golangci-lint v2、govulncheck、PGO、CI)。
使用方式:支持内联模式,仅在开发者正在编写的文件或功能范围内提出相关建议,避免无关改动;显式调用 /golang-modernize 或 CI 中触发全库扫描,可用最多五个并行子代理按类别扫描后汇总排序。全库改写应在隔离 worktree 中进行,经审查后再合并。被明确忽略的建议以每行一条的格式写入 .modernize,不再重复提示。更新依赖前需运行 go mod tidy 与测试套件,并请开发者查看变更日志。重命名标识符或替换已弃用 API 时可配合 gopls 相关技能安全重命名。
适用场景:适用于希望跟进 Go 新版本特性、清理弃用用法、统一惯用写法并引入现代化 CI 检查的 Go 项目。
限制:范围约为最近三年 Go 版本,目标 go.mod 更旧时覆盖更窄,建议先升级 Go 版本;许多 1.21 之前的改进被有意略过。Go 1.27 升级前需检查 GOEDEBUG 键移除与 crypto/tls.Config.Rand 调用方等风险;编码/json/v2 等变更需先核对真实负载。具体版本差异与修复器覆盖随工具版本而定,部分内容暂未提供。