VS Code安装Go工具时出现invalid GOSUMDB错误的原因与解决

问题场景 #

使用VS Code内置的「Go: Install/Update Tools」命令安装Go工具时，全部7个工具（gopls、gotest、gomodifytags、impl、goplay、dlv、staticcheck）均触发报错，错误信息如下：

verifying module: invalid GOSUMDB: malformed verifier id

环境信息 #

• Go版本：go1.22.5
• 操作系统：macOS
• 架构：amd64

已尝试的排查步骤 #

• 重启VS Code
• 重新安装Go
• 重新安装VS Code Go扩展
• 删除Go模块缓存（go clean -modcache）

问题1：导致该错误的原因是什么？ #

核心原因是GOSUMDB环境变量配置异常，具体可能是以下情况之一：

• GOSUMDB的值格式不符合Go规范，比如验证者ID（verifier id）输入错误，或被其他程序篡改了配置。
• 本地sumdb（Go模块校验数据库）缓存损坏，go clean -modcache并未完全清理sumdb相关缓存。
• 网络代理、DNS解析问题导致无法正确获取sumdb的验证者信息，进而触发格式错误判断。

问题2：具体解决方案 #

1. 重置GOSUMDB为默认值 #

在终端执行命令重置配置：

go env -w GOSUMDB="sum.golang.org"

若无法访问默认地址，可改用国内镜像：

go env -w GOSUMDB="goproxy.io.sumdb"

执行完成后重启VS Code，再尝试安装工具。

2. 完全清理sumdb缓存 #

除了模块缓存，手动删除sumdb的本地缓存目录：

rm -rf $HOME/Library/Caches/go-build
rm -rf $HOME/go/pkg/sumdb

清理完成后重新执行工具安装命令。

3. 检查并修复GOSUMDB格式 #

先查看当前配置：

go env GOSUMDB

正常格式应为[数据库地址]+[验证者ID]，比如默认的sum.golang.org+033de0ae+Ac4zctda0e5eza+HJyk9SxEdh+s3Ux18htTTAD8OuAn。如果格式错误，直接用步骤1的命令重置。

4. 临时禁用模块校验（不推荐长期使用） #

若以上方法均无效，可临时关闭sumdb校验（存在安全风险，安装完成后建议恢复）：

go env -w GOSUMDB=off

5. 排查网络环境 #

确保网络可正常访问sum.golang.org（或使用的镜像地址），关闭代理软件或切换网络后重试安装。

内容的提问来源于stack exchange，提问作者Ryuu Osamu