11 月 10 日,Go 开源项目迎来 17 周年。Go 官方在周年文章中专门提到一个现实问题:AI 编码助手容易沿用训练数据中占多数的旧写法。

Go 语言和标准库持续更新,但 AI 生成的代码可能仍然停留在几年前。代码通常可以正常运行,维护时却需要重新判断哪些写法应该迁移。
这里讨论的是代码风格和 API 使用没有跟上 Go 演进,并不是把 AI 生成的代码一概判定为不合格。
提醒 AI,也未必管用
Alan Donovan 在今年 2 月发布的go fix 介绍文章中,分享过一个更具体的观察。
Go 团队从 2024 年底开始注意到,编码助手生成的 Go 代码经常接近训练数据中的旧风格。即使明确要求使用新版 Go 的写法,也不一定能让它完成迁移。
有些情况下,直接告诉模型使用某个新特性,它甚至会否认这个特性的存在。
这就有些尴尬了:语言已经支持,工具却还在争论这个特性是否存在。
当然,这只是作者对当时现象的描述,不能据此断言今天的每个 AI 工具都会这样。
而且,人也会写旧代码。
例如,读取文件过去常见的是 ioutil.ReadFile,后来推荐使用 os.ReadFile。翻看老项目或搜索代码片段时,复制一次旧示例,项目里就可能再次出现旧接口调用。
旧写法不等于有 bug。 Go 有兼容性承诺,旧接口不会因为出现替代方案,就让已有项目集体编译失败。
但维护项目时,总不能每次都依靠人工记住有哪些新写法,再逐处提醒 AI。Go 团队给出的方向,是让工具按照明确规则处理这类迁移。
go fix 改了什么
这个工具就是 go fix。它早已存在,并在 Go 1.26 中重新实现,周年文章也回顾了这项工作。
根据Go 1.26 版本说明,新版 go fix 建立在 Go 静态分析框架之上,与 go vet 使用同一套基础设施,并加入了一批代码现代化规则。
go vet 主要负责报告可疑问题;go fix 则会把符合规则的修改落实到源码中,例如采用新的语言写法、迁移标准库 API。
它处理的是规则能够识别的具体改动,不会替你判断业务需求是否正确。
这些规则同样适用于人工编写的代码。AI 编码助手也可以调用它,把生成结果中符合迁移条件的旧写法改掉。
更有意思的是,库作者也能参与这项迁移。
过去接口废弃后,添加一行 Deprecated 注释,调用方什么时候修改,基本只能依靠人工维护。现在可以通过 //go:fix inline 告诉工具:这个旧函数适合展开到调用处。
下面是一个自拟的配置读取示例,省略了包声明和 os 的导入:
// Deprecated: 请改用 os.ReadFile。
//go:fix inline
func ReadConfig(p string) ([]byte, error) {
return os.ReadFile(p)
}
假设调用方导入这个包时使用的名称是 config,原来的代码如下:
b, err := config.ReadConfig("app.json")
按照源码内联机制,对于这种简单的转发函数,工具可以把调用修改为下面这样,并同步调整导入:
b, err := os.ReadFile("app.json")
这组迁移是按照官方机制给出的示意,未在本机执行新版 go fix。对于这个转发函数来说,替换依据直接写在函数体中。

添加注释不会远程修改用户的仓库。调用方需要获取带有该注释的库版本,再运行工具。旧函数也不会因此自动删除,尚未迁移的调用者仍然需要它。
这里的“内联”会直接修改源码。编译器为了优化机器码而执行的内联,是另一回事。
如果参数存在副作用,工具还需要保留求值顺序,必要时引入临时变量。简单地替换函数名、把参数直接塞进去,并不一定保持原有语义。
换成新写法,也可能改出问题
“改成新版写法”不能变成无条件执行的要求。无论让 AI 修改,还是使用工具迁移,都必须检查行为是否发生变化。
官方现代化工具文档中有一个 appendclipped 规则。它尝试简化某些切片拼接和复制操作,但由于无法在所有情况下保留 nil 状态,目前处于默认禁用状态。
下面用一个 nil 切片观察差异。这个最小示例已经在本机 Go 1.24.1 上运行:
var src []string
a := append([]string{}, src...)
b := slices.Clone(src)
fmt.Println(a == nil, b == nil)
// false true
两份结果的长度都是 0,但 a 是非 nil 的空切片,b 是 nil。根据 slices.Clone 的约定,它会保留输入的 nil 状态。
如果输入换成非 nil 的空切片,Clone 的结果也不会是 nil。因此,不能把“长度为 0”和“值为 nil”混为一谈。
这个区别平时可能不明显,遇到 JSON 编码时就会暴露出来:
ja, _ := json.Marshal(a)
jb, _ := json.Marshal(b)
fmt.Println(string(ja), string(jb))
// [] null
这里使用传统的 encoding/json,直接编码两个字符串切片;示例中的具体值不会产生编码错误。

原本返回 [] 的接口,如果被这样替换,就可能返回 null。如果接口约定这里必须是数组,下游的响应校验就可能失败。
代码变短了,不代表行为没有变化。
所以,即使自动迁移最后只改了一两行,也要检查类型、边界输入和副作用。这些细节正是人工 review 时容易一扫而过的地方。
AI 写完以后,怎么检查
使用这套新版能力,需要 Go 1.26 或更新的工具链。先把 AI 生成的改动保存成独立提交,再执行迁移,方便将两批改动分开检查。
在模块目录中先预览差异:
go fix -diff ./...
-diff 只展示拟议修改,不会写入文件。根据命令文档,存在差异时命令也会返回非零状态,因此不能只凭退出码判断分析是否失败。
先查看诊断信息。如果加载包、类型检查等环节报错,应先解决报错,再重新预览。没有得到 diff,并不代表没有可迁移的代码。
确认这批差异都可以接受后,再使用相同的包范围和构建配置应用修改,然后跑项目测试:
go fix ./...
go test ./...
go fix ./... 会运行本次启用的整批规则,不会记住你刚才在 diff 中挑选了哪几行。
如果只想处理某一类改动,应先限制分析器范围,例如使用 -any 只启用某条规则。预览和应用时要使用相同的选择。应用之后,还要检查实际的 Git diff。
还有两个容易被忽略的条件。
第一是目标 Go 版本。分析器会结合 go.mod 和构建标签确定文件版本,避免加入过新的语法。项目如果还需要兼容旧版本,不要为了让差异更多,顺手提高最低支持版本。
第二是构建范围。一次分析只覆盖当前构建配置。对于按平台区分的代码,应结合实际支持的 GOOS 和 GOARCH 分别检查。
生成文件也需要单独处理:go fix 会丢弃涉及生成文件的修复。如果确实需要修改这类代码,应回到生成器处理,否则下次重新生成时修改还会消失。
至于当前工具链到底包含哪些规则,可以查看:
go tool fix help
不要把网上某个分析器的介绍,直接当成当前版本的默认行为。前面的切片例子,就是需要特别留意的差异。
我会把这套检查放在 AI 生成代码之后:先确认工具完成了分析,再审查本批修改;如果不接受,就缩小迁移范围并重新预览。整体流程如下。

维护者重点要看对外行为是否变化,尤其是返回值、错误和序列化结果。命令退出成功,只能说明命令执行完毕,不能替业务验收签字。
总结
Go 这次提到的 AI 问题很具体:语言持续向前发展,但生成代码采用的写法可能仍然停留在旧版本。
把能够按规则处理的迁移交给工具,可以减少逐处提醒和手工替换。但采用新 API、减少几行代码,都不能取代对业务行为的检查。
下次 AI 帮你写完一段 Go,可以在项目支持的版本范围内运行一次 go fix -diff ./...,看看有没有可以迁移的旧写法,再回头检查测试覆盖了哪些场景。
毕竟,前面那个 [] 变成 null 的例子,编译器不会替你拦住下游问题。
参考资料
- 周年文章
- 介绍 go fix 的文章
- Go 1.26 版本说明
- 源码内联机制
- appendclipped 默认禁用说明
slices.Clone 的约定
encoding/json
- go fix 命令文档
- 限制分析器范围