VSCode + 官方go工具链 + gopls是最轻量、稳定且维护成本最低的本地Go开发组合；需先验证go version（推荐1.21–1.25 LTS版本）、go env GOPATH/GOROOT路径规范及PATH包含$GOROOT/bin和$GOPATH/bin，再安装Go扩展并确保gopls正常运行，项目须预先执行go mod init，调试优先使用Ctrl+F5触发自动配置。
VSCode + 官方 go 工具链 + gopls 是当前最轻量、最稳定、维护成本最低的本地 Go 开发组合，不需要额外 IDE 或复杂插件堆叠。
确认 go 命令已就位且版本合理
别急着装插件，先确保终端里 go 能跑通。VSCode 的 Go 扩展本质是调用本地 go 命令和 gopls 语言服务器，底层不稳，上层全抖。
- 运行
go version，推荐使用 Go 1.21–1.25 之间的 LTS 版本（如go1.23.5），太新（如 1.26+）可能触发gopls尚未适配的语法变更 - 执行
go env GOPATH和go env GOROOT，确认路径无空格、无中文；GOROOT应指向安装目录（如/usr/local/go），GOPATH默认为$HOME/go，无需强制修改 - 检查
PATH是否包含$GOROOT/bin和$GOPATH/bin，否则gopls、dlv等工具会找不到
VSCode 中只启用必要扩展
VSCode 的 Go 扩展（golang.go）已内置对 gopls 的绑定，新版不再依赖旧工具链（如 go-outline、go-imports）。开多了反而冲突。
- 卸载所有非官方 Go 插件，尤其避免同时启用多个语言服务器（比如
Go for Visual Studio Code和第三方Go Language Pack） - 安装后重启 VSCode，打开任意
.go文件，状态栏左下角应显示gopls (running)，不是gopls (initializing)或报错 - 若卡在 initializing，多半是
GOPROXY不通或模块初始化失败，可临时设为https://goproxy.cn,direct验证
go.mod 初始化要早于编辑器介入
VSCode 的 Go 扩展默认按 module 模式工作，如果项目根目录没有 go.mod，它会拒绝提供补全、跳转等核心功能，而不是自动帮你生成。
立即学习“go语言免费学习笔记（深入）”；
- 新建项目时，先 cd 到项目目录，运行
go mod init example.com/myapp（模块名不必真实可访问，但需符合域名格式） - 不要依赖 VSCode 右键菜单里的 “Initialize Go Module”，它有时会忽略
GO111MODULE=on环境变量，生成空或错误的go.mod - 若已有代码但无
go.mod，直接运行go mod init即可，gopls会在几秒内重新加载项目结构
调试配置别绕过 dlv CLI
VSCode 的调试功能本质是封装 dlv，但很多人卡在 launch.json 配置上，其实多数场景根本不需要手动写。
- 确保
dlv已安装：go install github.com/go-delve/delve/cmd/dlv@latest，完成后dlv version应返回正常输出 - 对单文件调试（如
main.go），直接按Ctrl+F5（Windows/Linux）或Cmd+F5（macOS），VSCode 会自动生成临时调试配置，无需预设launch.json - 只有多包、远程调试或需自定义
env/args时，才需要手写.vscode/launch.json，且务必指定"mode": "exec"或"mode": "test"，别用已弃用的"mode": "auto"
最容易被忽略的是：VSCode 启动时读取的是当前 shell 的环境变量，不是你 ~/.zshrc 里改完就生效的。新开终端验证 go env 后，再启动 VSCode（用命令行 code . 最可靠），否则 GOPROXY、GOBIN 等设置可能不被识别。
