编程 gopls v0.24.0:汇编文件也能 hover,Go 1.28 前得把 string(int) 换掉

2026-11-16 21:31:07

gopls v0.24.0:汇编文件也能 hover,Go 1.28 前得把 string(int) 换掉

gopls v0.24.0(Oct 2026)的发布说明见 go.dev/gopls/release/v0.24.0,文档源文件在 golang.org/x/tools/gopls/doc,包页面在 pkg.go.dev/golang.org/x/tools/gopls。

go install golang.org/x/tools/gopls@v0.24.0
gopls version

LSP 3.18

gopls 现在支持 Language Server Protocol v3.18。

汇编文件支持

这个版本补齐了 Go 汇编文件的一批交互能力:Hover、DocumentHighlight、References,以及“零配置”——自动选择合适的构建标签。

配置变更

memoryLimit

新增 memoryLimit 设置,客户端可以通过 runtime/debug.SetMemoryLimit 给 gopls 进程设一个软内存上限。该特性目前是实验性的。它的用法是用更多 CPU 换更低的稳态内存占用;但如果设得太低,会触发 GC thrashing,也就是 GC 频繁回收、吞吐反而下降。

VS Code 的 settings.json 写法:

{
  "gopls": {
    "memoryLimit": 2147483648
  }
}

semantic tokens 的客户端契约被强制执行

服务端现在会强制检查 SemanticTokensClientCapabilities 的 TokenTypes 和 TokenModifiers 两个字段。gopls 返回的 semantic token 类型与修饰符被限制在这两个列表的范围内。因此客户端必须完整列出自己支持的 token 能力,漏列的类型不会出现在结果里,表现就是高亮缺失。

gopls 的 UI 设置 semanticTokenTypes 和 semanticTokenModifiers 仍然保留,用户可以在客户端能力之上进一步收窄列表:

{
  "gopls": {
    "semanticTokenTypes": [
      "namespace", "type", "class", "enum", "interface", "struct",
      "typeParameter", "parameter", "variable", "property", "enumMember",
      "event", "function", "method", "macro", "keyword", "modifier",
      "comment", "string", "number", "regexp", "operator", "decorator"
    ],
    "semanticTokenModifiers": [
      "declaration", "definition", "readonly", "static", "deprecated",
      "abstract", "async", "modification", "documentation", "defaultLibrary"
    ]
  }
}

上面是 LSP 标准里的 token 全集;这两项只在客户端已经声明支持的前提下生效,收窄得越狠,编辑器里能看到的语义着色就越少。

零配置也认汇编文件

“零配置”指的是 gopls 自动为打开的 Go 源文件挑选合适的 OS/ARCH 组合来构建。现在这套逻辑同样会考虑打开的 Go 汇编文件。

被动特性

gopls 现在支持在 Go 汇编文件里发 Hover 请求:悬停在符号上,会显示它对应的 Go 声明的签名和文档注释。

编辑特性

type switch 的 case / default hover

悬停在 type switch 的 case 或 default 关键字上,会列出该分支处理的、且与 switch 操作数接口类型声明在同一包内的类型。悬停在 default 上因此能看到一个本意想穷举的 switch 漏掉了哪些类型。对于非接口类型的 case,只有当它被前面的分支挡住、实际不可达时才会显示信息。

包名 hover 里的文档链接

悬停在包名的定义、引用或 import 上时,文档里的链接会渲染成指向代码定义或 pkgsite 的链接。例如注释 // xyz uses [TestA.FieldOne] 中的 [TestA.FieldOne]。

汇编文件的 documentHighlight 与 references

textDocument/documentHighlight 在 Go 汇编文件里可用:光标下的符号、label 或机器寄存器的所有出现位置会在所属的 TEXT 函数内高亮,其中定义归类为写,引用归类为读。

textDocument/references 在汇编文件里现在支持控制 label,以及没有对应 Go 声明的符号。

completion 的 labelDetails

对被声明支持 completionItem.labelDetailsSupport 的客户端,补全项现在会带上 labelDetails:detail 放签名或类型,description 放接受该项后会加进文件的 import 路径。只有会引入 import 的项才有 description,客户端可以据此给这些项做标记。

分析特性

gopls 现在使用 staticcheck v0.8.1。

ptrtoerror

新分析器报告同一个命名类型 E 与它的指针类型 *E 被不一致地当作 error 使用。

声明 func (E) Error() string 之后,E 和 *E 都实现了 error,于是包里可能一处返回 E{...}、另一处返回 &E{...}。这是潜在 bug:用类型断言或 errors.Is 做检查的调用方必须二选一,而错误是用另一种形式创建的时候,检查会静默失败。

分析器报告三类问题:

  • 在声明 E 的包内,E 和 *E 两种值都被转成 error。分析器报告类型声明和每一处转换。
  • 声明包一致地只用一种形式,但另一个包把另一种形式转成了 error。分析器报告那个包里的转换位置,并指出声明包使用的是哪种首选形式。
  • E 和 *E 都实现了 error,但声明包两种都没转成 error,意图不明。分析器提供两个备选修复来显式声明意图:var _ error = *new(E) 或 var _ error = (*E)(nil)。

slicesclip

新的 slicesclip modernizer 建议把 x[:len(x):len(x)] 这种把切片容量截到长度的完整切片表达式,换成 Go 1.21 引入的 slices.Clip(x)。

importcomment

新的 importcomment modernizer 删除过时的规范 import 路径注释,例如 package foo // import "example.com/foo"。go 命令只在 GOPATH 模式下强制这类注释,模块模式下会被忽略。

reflecttypeassert

新的 reflecttypeassert modernizer 建议把对 reflect.Value.Interface 结果的双值类型断言 x, ok := v.Interface().(T) 换成 Go 1.25 引入的 x, ok := reflect.TypeAssert[T](v),后者不分配中间接口值。

单值断言不提供修复:单值断言失败会 panic,而 reflect.TypeAssert 不会,两者语义不同,不能直接替换。

stringintconv 适配 Go 1.28

Go 1.28 拒绝 string(x) 这种把非 byte、非 rune 整数转成字符串的写法(#3939)。stringintconv 的第一个建议修复现在精确保持原有行为:用 string(rune(x));对宽度超过 32 位的类型则用 fmt.Sprintf("%c", x),因为截断到 rune 可能把一个非法码点变成合法码点。第二个修复是 fmt.Sprintf("%d", x),把数字按十进制格式化。

在 Go 1.28 及之后的文件里,同一个类型错误现在也直接提供这两个 quick fix。

代码变换特性

“实现接口”支持泛型接口

交互式 code action “Add methods to implement an interface…” 现在支持泛型接口。当所选接口带类型参数时,gopls 会为每个类型参数询问一个类型实参,并生成实例化后的方法签名 stub。

交互式对话框演示:“Slay the dragon”

LSP 标准目前没有让服务端向客户端提问的机制,比如“这个函数应该挪到哪里”或者“这个有歧义的操作要不要继续”。

Go 团队与 Dart IDE 团队合作设计并实现了一个 LSP 扩展来支持交互式对话框。目前正在推动它被 LSP 标准采纳,并在各主流客户端编辑器中实现,后续的交互式特性也计划基于它。

作为该特性的演示和客户端实现的测试用例,gopls 现在会在你选中一个名为 dragonSlayer 的包级变量时提供 “Slay the dragon” code action。代码附近发现了一条龙,接下来会发生什么由你决定。

文档源文件位于 golang.org/x/tools/gopls/doc。

复制全文 生成海报 Go gopls LSP 工具链 静态分析

推荐文章

程序员茄子在线接单