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/delve@v1.26.0 requires go >= 1.24; switching to go1.24.11

go: downloading go1.24.11 (windows/amd64)

go: download go1.24.11: golang.org/toolchain@v0.0.1-go1.24.11.windows-amd64: 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/gopls@v0.21.0 requires go >= 1.25; switching to go1.25.5

go: downloading go1.25.5 (windows/amd64)

go: download go1.25.5: golang.org/toolchain@v0.0.1-go1.25.5.windows-amd64: 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/gopls@v0.21.0 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/gopls@v0.15.0

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

2、验证安装

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

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

相关推荐
xcLeigh31 分钟前
Go入门:短变量声明的陷阱与最佳实践
java·redis·golang·教程·变量
JavaPub-rodert1 小时前
我又把自己的 Go 后台管理系统升级了一遍:文件管理、2GB 上传、私有文件预览、Docker 镜像全安排上了
开发语言·docker·golang·shiyuadmin
青 春 记 忆1 小时前
零基础入门python04:用注册校验理解字典、集合和条件判断
开发语言·vscode·python·python3.11
名字还没想好☜1 小时前
Go 的 sync.Cond 实战:用条件变量做等待/通知,比忙轮询省 CPU
开发语言·数据库·后端·golang·go
00后程序员张5 小时前
有没有更轻量的 iOS 开发环境?快蝎kxapp轻量化路径与构成
ide·vscode·ios·objective-c·个人开发·swift·敏捷流程
buhuizhiyuci6 小时前
【Linux 网络篇】数据的 “循环系统“:协议认识与网络传输的流程
linux·运维·服务器·网络·vscode
猿小猴子20 小时前
主流 Agent 之 「Zed」和 「ZCode」 介绍
ide·ai·agent·zed·zhipu·ade·zcode
啊哈一半醒1 天前
Go 语言 Context 全方位详解:原理、实战与避坑
开发语言·后端·golang
名字还没想好☜1 天前
Go 的 io.Reader/Writer 组合实战:io.Copy、TeeReader、MultiWriter 优雅处理数据流
开发语言·后端·golang·go·iphone