如何设置VSCode以完整搭建Go语言开发工具链？

本文共计948个文字，预计阅读时间需要4分钟。

VSCode使用Go语言项目时，若遇到gopls无法启动、dlv找不到或根本未在module根目录打开等问题，导致补全、跳转、调试等功能失效，请检查以下步骤：

go version 和 GOPROXY 必须先验证好

gopls 启动依赖系统 go 命令，如果 go version 报错或低于 1.21，语言服务器直接跳过加载；而所有工具（gopls、dlv）下载失败的头号原因，是 GOPROXY 没生效。

• 终端运行 go version，确认输出类似 go version go1.22.5 darwin/arm64；若报 command not found，先检查 GOROOT 和 PATH
• 执行 go env -w GOPROXY=https://goproxy.cn,direct（国内推荐），再用 go env GOPROXY 确认写入成功
• 别信 GO111MODULE=on 就万事大吉——它只影响模块行为，不解决代理问题

gopls 不显示 running？检查 GOPATH 和 GOBIN 是否可写

gopls 默认安装到 $GOPATH/bin。该路径不存在、不可写，或没加入 PATH，VSCode 就会卡在 “Loading…” 或反复崩溃。