goroot 仍需正确设置，gopath 在 go 1.16+ 模块模式下通常无需手动配置；goroot 必须指向 go 安装根目录（如 c:\go），且 path 需包含 $goroot\bin，否则 go 命令将不可用。
GOROOT 和 GOPATH 还得手动配吗？
现代 Go（1.16+）已默认启用 GO111MODULE=on，GOPATH 对模块化项目不再是硬性依赖，但 GOROOT 仍必须正确指向 Go 安装根目录，否则 go 命令会找不到标准库。
常见错误现象：go: cannot find main module 或 command not found: go，多数是 PATH 没包含 $GOROOT/bin；go env 显示 GOROOT="" 则说明变量未设或设错。
-
GOROOT应设为 Go 安装路径（如 Windows 是C:\Go，macOS 是/usr/local/go），不要指向子目录（比如别设成C:\Go\bin） -
GOPATH可不设——若设，必须是**纯英文路径、无空格、无中文**；VSCode 的 Go 扩展默认会用$HOME/go（Linux/macOS）或%USERPROFILE%\go（Windows）作为 fallback - 验证方式：终端执行
go env GOROOT GOPATH，两行输出都应为非空且路径可访问
gopls 安装失败的典型原因和绕过方法
gopls 是 VSCode Go 扩展的核心语言服务器，安装失败直接导致补全、跳转、诊断全部失效。最常卡在 go install golang.org/x/tools/gopls@latest 这一步。
根本原因不是“网络差”，而是 Go 默认代理 proxy.golang.org 在国内不可达，且 GO111MODULE 开启后会强制走模块代理，不再读取本地 src 目录。
- 优先设置代理：运行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐七牛云源） - 如果公司内网禁用外部代理，可临时关闭模块：执行
go env -w GO111MODULE=off，再手动把gopls源码 clone 到$GOPATH/src/golang.org/x/tools，然后go install golang.org/x/tools/gopls - 验证是否生效：打开
.go文件，VSCode 状态栏右下角应显示gopls (running)，悬停函数能看到文档
dlv 调试器必须装，但别用 go get
VSCode 调试 Go 程序依赖 dlv（Delve），但它**不能用已废弃的 go get 安装**——Go 1.17+ 已移除该命令对二进制工具的支持，强行运行只会报错 go get: installing executables with 'go get' in module mode is deprecated。
正确做法只有一种：go install + 指定版本后缀。
- 装最新稳定版：
go install github.com/go-delve/delve/cmd/dlv@latest - 若需特定版本（如适配旧 Go 版本），查 Delve 发布页选 tag，例如：
go install github.com/go-delve/delve/cmd/dlv@v1.22.0 - 装完检查：
dlv version应输出版本号；VSCode 中按F5启动调试时，终端里会看到dlv dap --listen=...进程启动 - 注意：Windows 用户若提示
'dlv' is not recognized，说明$GOPATH/bin（或%USERPROFILE%\go\bin）没加进系统PATH
VSCode 自动提示安装工具时，别全点“Install All”
首次打开 .go 文件，VSCode 会弹窗提示“Missing tools”，列出 gopls、dlv、gofmt、goimports 等十几个工具。此时点击 Install All 极大概率失败——它内部仍调用旧式 go get，且不支持代理配置。
更可靠的做法是分步手动安装，只装真正需要的几个：
- 必装：
gopls（语言服务）、dlv（调试）、gofumpt（格式化，比gofmt更严格，VSCode Go 扩展默认启用） - 可选：
gomodifytags（结构体标签操作）、impl（接口方法实现生成） - 不用装：
golint（已弃用）、guru（gopls已覆盖其功能）
装完任一工具后，VSCode 不会自动重试失败项，需手动触发：Ctrl+Shift+P → 输入 Go: Install/Update Tools → 勾选要装的工具再确认。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
