Go 1.16+ + VSCode + gopls 足够，无需配置 GOPATH 或旧插件；需确保 go version 和 go env 正常，GO111MODULE=on、GOPROXY 已设，仅保留官方 Go 扩展并启用 gopls，新建项目直接 go mod init，调试优先用命令行验证。
直接用 Go 1.16+ + VSCode + gopls 就够了，别折腾 GOPATH 或旧插件（如 gocode），Go Modules 已成默认，硬配 GOPATH 反而容易出错。
go version 和 go env 必须先跑通
装完 Go 后第一件事不是写代码，而是确认基础链路：终端执行 go version 能输出版本（如 go version go1.22.5 windows/amd64），再跑 go env 看关键变量是否合理：
-
GOPATH不再强制要求 —— 如果没手动设，go env里它可能为空或指向%USERPROFILE%\go，这完全 OK -
GOPROXY必须设，国内推荐https://goproxy.cn,direct或https://goproxy.io,direct -
GO111MODULE应为on（1.16+ 默认开启，不用额外设）
VSCode 插件只留 gopls，删掉所有旧 Go 插件
VSCode 官方 Go 插件（golang.go）底层已全面切换到 gopls 语言服务器。保留 gocode、godef、go-outline 这类旧工具会导致补全卡顿、跳转失效、甚至和 gopls 冲突：
- 卸载所有非官方 Go 插件，只保留 Microsoft 官方的
golang.go - 在 VSCode 设置里搜
go.gopls，确认go.gopls.enabled是 true - 首次打开 Go 文件时，VSCode 会自动下载
gopls二进制，如果卡住，手动运行go install golang.org/x/tools/gopls@latest
新建项目直接 go mod init，别碰 GOPATH/src
独立开发不需要模拟传统 GOPATH 结构。每个项目就是独立目录，根目录下执行：
立即学习“go语言免费学习笔记（深入）”；
go mod init myapp
后续所有依赖都由 go mod 自动管理，go run、go build 都能正确解析 import 路径。常见误区：
- 不要把项目放到
%GOPATH%\src\...下 —— 这是 Go 1.11 之前的习惯，现在反而干扰 module 解析 - 如果
go mod init报错 “module root not in GOPATH”，说明你还在用老脚本或 IDE 模板，删掉重来 - 本地开发时，跨包引用写相对路径即可，比如
import "myapp/internal/handler"，无需加域名前缀
调试和运行别依赖 IDE 的“一键运行”按钮
VSCode 的调试器（Delve）虽好，但独立开发者更应习惯命令行驱动流程，避免被 GUI 隐藏细节坑住：
- 写完
main.go，直接终端跑go run main.go，比点绿色三角更可靠 - 调试时用
dlv debug而非 IDE 图形断点 —— 尤其当你需要传参数或改环境变量时，命令行更透明 - 构建可执行文件用
go build -o app.exe .，检查生成物大小和平台兼容性（比如加GOOS=linux GOARCH=amd64交叉编译）
真正麻烦的从来不是装工具，而是某天发现 go run 失败却查不出是 go.mod 错了、还是 GOPROXY 超时、或是 VSCode 没 reload workspace —— 这些边界情况，只有靠命令行逐层验证才能快速定位。
