只要正确安装go二进制包、设置goproxy、安装vscode go扩展并自动安装工具，即可运行go run和调试；go 1.16+ modules模式下手动配置go.gopath等已失效，需确保go111module=on、goproxy=https://goproxy.cn,direct，并通过vscode的go: install/update tools安装gopls与dlv。
只要装对 Go 二进制包、设好 GOPROXY、装对 VSCode 的 Go 扩展并让它自动装工具，就足够跑 go run 和调试了。其他配置项（比如手动填 go.gopath）在 Go 1.16+ + modules 模式下基本失效，填了反而容易冲突。
go version 能跑但 go mod init 报错：proxy 或 module 模式没开
常见现象是执行 go mod init example.com/hello 时卡住或报 no required module provides package。这不是环境变量问题，而是模块功能被禁用或代理不可达。
- 运行
go env -w GO111MODULE=on强制启用 modules（Go 1.16+ 默认开启，但某些旧系统或 Docker 镜像里仍为 auto 或 off） - 国内用户必须配
GOPROXY，推荐执行：go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct；再试go mod download github.com/gorilla/mux，不报错即通
VSCode 里没提示、不能跳转、gopls 一直 loading
这是官方 Go 扩展（Go by Go Team at Google）没拉齐工具链，不是路径配置问题。新版扩展默认走 gopls，而 gopls 依赖 go 命令本身能正常调用，且会自动下载所需工具。
- 确保终端里
go version和go env GOPROXY都正常，否则 VSCode 继承不到这些环境 - 在 VSCode 里按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Go: Install/Update Tools，全选后回车——它会用你当前go环境去装gopls、dlv、goimports等 - 如果卡在
gopls编译，说明GOPROXY没生效或网络不通；不要手动go install golang.org/x/tools/gopls@latest，VSCode 的安装流程已处理版本兼容性
调试按钮灰色、dlv 找不到或启动失败
dlv 是 Delve 调试器的命令行入口，VSCode 的 Go 扩展调试功能完全依赖它。灰色按钮 = 扩展没检测到 dlv 可执行文件。
- 先确认
dlv是否已装：which dlv（macOS/Linux）或where dlv（Windows），无输出就说明没装 - 不要用
go get安装——它已被弃用且易出错；统一用 VSCode 的Go: Install/Update Tools流程装 - 装完后重启 VSCode，打开一个
main.go文件，点右上角“运行和调试”→“创建 launch.json”，选 “Go” → “Launch Package”，生成的配置里"mode": "auto"即可，不用改dlvPath - 若仍失败，检查项目根目录是否有
go.mod：没有的话dlv无法识别模块边界，调试器会拒绝启动
真正卡住人的从来不是“装了多少东西”，而是 go 命令本身能否连上代理、gopls 能否静默完成初始化、dlv 是否由同一套 go 环境生成——这三者链条断一环，编辑器就只剩语法高亮。别碰 GOROOT 和 GOPATH 手动设置，现代 Go 已经不需要它们驱动 IDE。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
