Visual Studio Code中实现Go语言自动导包教程

一、在VS Code中安装Go需要的扩展

首先，按住Ctrl + Shift + P调出命令面板，输入

Go:Install/Update Tools 

全选安装，等待安装完毕
显示这行输出，就代表安装成功了

tips：如果你出现了下面的报错

2026-01-08 15:25:29.074 [info] dlv: failed to install dlv(github.com/go-delve/delve/cmd/dlv@latest): Error: Command failed: A:\Go\bin\go.exe install -v github.com/go-delve/delve/cmd/dlv@latest
go: downloading github.com/go-delve/delve v1.26.0
go: github.com/go-delve/[email protected] requires go >= 1.24; switching to go1.24.11
go: downloading go1.24.11 (windows/amd64)
go: download go1.24.11: golang.org/[email protected]: verifying module: checksum database disabled by GOSUMDB=off

2026-01-08 15:25:29.074 [info] gopls: failed to install gopls(golang.org/x/tools/gopls@latest): Error: Command failed: A:\Go\bin\go.exe install -v golang.org/x/tools/gopls@latest
go: downloading golang.org/x/tools v0.40.0
go: golang.org/x/tools/[email protected] requires go >= 1.25; switching to go1.25.5
go: downloading go1.25.5 (windows/amd64)
go: download go1.25.5: golang.org/[email protected]: verifying module: checksum database disabled by GOSUMDB=off

解决步骤：
1.设置 Go 代理

go env -w GOPROXY=https://goproxy.cn,direct 

2.开启校验和数据库（关键）
你的报错明确写着 checksum database disabled by GOSUMDB=off。
这意味着你之前（或者某些安装教程）强制关闭了安全校验。开启它才能下载官方工具。
运行以下命令重置为默认（或开启）：

go env -w GOSUMDB=sum.golang.org 

如果这条之后仍然连不上，可以换成国内镜像：

go env -w GOSUMDB=sum.golang.google.cn 

3.检查系统时间（重要）
如果你现在的电脑时间有误，请改回正确的时间。

4.重新安装工具
完成上述设置后，再次尝试安装 VSCode 提示的工具。

你可以选择在 VSCode 终端手动运行，也可以点 VSCode 的 Install All。

手动安装命令：

go install -v github.com/go-delve/delve/cmd/dlv@latest go install -v golang.org/x/tools/gopls@latest 

使用下面命令，正常输出版本号就表示能运行

go run golang.org/x/tools/gopls@latest version 

二、导入go依赖包

将鼠标悬浮到你想导入包的代码上

选择go get package github.com/gin-gonic/gin

等待导包完成，就可以实现vscode中的自动导包了

tips：
以下是几条命令解释：
GOROOT：通常是你安装 Go 软件的目录，比如 D:\Go。
GOPATH：是你的“工作空间”目录，通常在 C:\Users\你的用户名\go。

GOPATH 的“开发模式”已经废弃
Go 官方 Wiki 明确说：GOPATH development mode（把代码放在 GOPATH/src 下面开发）已经废弃，Go 1.16 以后默认就是模块模式，以后 GOPATH mode 会完全移除

GOPATH 现在主要用途只剩 3 件事

在使用 Go 模块（你现在的 backend 目录有 go.mod）的情况下，GOPATH 变量的作用主要是https://go.dev/wiki/GOPATH：
go install 安装命令行工具（比如 gopls、dlv）到：
$GOPATH/bin（如果没单独设置 GOBIN）
go get 缓存模块到：
$GOPATH/pkg/mod
校验和数据库缓存：
$GOPATH/pkg/sumdb

建议保留唯一的D:\GoProjects\library 作为唯一的 GOPATH
终端直接修改命令：

go env -w GOPATH="D:\GoProjects\library" 

使用下面命令查看当前GOPATH

go env GOPATH 

如果出现以下报错：

go: golang.org/x/tools/[email protected] requires go >= 1.25; switching to go1.25.5

有两种方案解决：
方案一：升级 Go 版本（推荐）
1、下载最新的 Go 版本
访问 https://go.dev/dl/
下载 Windows 版本的 Go 1.23 或更高版本

2、安装新版本
运行安装程序
重启 VSCode

3、验证安装
使用以下命令验证go版本

go version 

4、重新安装 gopls

go install -v golang.org/x/tools/gopls@latest 

方案二：降级 gopls 版本（如果不便升级 Go）
如果暂时无法升级 Go 版本，可以使用与 Go 1.22.3 兼容的 gopls 版本：
1、安装兼容的 gopls 版本

go install -v golang.org/x/tools/[email protected] 

不确定版本是否匹配，只是举个例子

2、验证安装

结论：经过验证目前最新版本Go 1.25.5 + gopls 0.21.0是匹配的

本文作者能力有限，如有不足之处还望在评论区指出，开发者们可以一起进步。