vs code配go开发环境只需装对官方go扩展和齐备工具链：先设goproxy=https://goproxy.cn,direct，再通过go: install/update tools安装gopls、dlv、goimports；格式化改用goimports并确保有go.mod；调试需dlv≥1.21.0且launch.json配置正确。
VS Code配Go开发环境，核心就两件事：装对扩展、装齐工具链。其他都是锦上添花，别被一堆配置项绕晕。
Go扩展必须装官方版，别信第三方
打开VS Code，按 Ctrl+Shift+X（Mac是 Cmd+Shift+X），搜“Go”，只认准作者是 Go Team at Google 的那个插件。它自带引导逻辑，能自动识别你有没有 gopls、dlv 等关键工具。装错名字相似的第三方插件（比如带“for Go”或“Enhanced”字样的），后期补全失效、跳转失灵、调试断点不触发，基本是板上钉钉的事。
- 装完别急着写代码，先打开任意一个
.go文件——右下角会弹出“Install All Tools”提示，点它 - 如果没弹，按
Ctrl+Shift+P输入Go: Install/Update Tools，全选，尤其是gopls和dlv，缺一不可 - 国内用户大概率卡在下载环节，不是插件问题，是网络——这时候得提前配好代理，而不是等报错再折腾
工具链下载失败？先配 GOPROXY 再重试
VS Code里点“Install All”失败，终端里常看到类似 failed to fetch https://proxy.golang.org/... 的错误。这不是你本地Go没装好，而是默认代理被墙了。别反复点击重试，直接改全局代理：
- 终端执行：
go env -w GOPROXY=https://goproxy.cn,direct - Windows用户若提示权限问题，用管理员身份开PowerShell再执行
- 改完后重启VS Code，再运行
Go: Install/Update Tools，90%以上能一次成功 - 注意结尾的
,direct不能删——它保证私有模块（比如公司内网Git）走直连，否则内部包会拉不到
保存自动格式化要关掉 gofmt，换 goimports
默认格式化用的是 gofmt，它只排版不管理导入包。结果就是你删了个 import "fmt"，保存后又自动加回来，或者新增函数调用却没自动补 import，很反直觉。
- 在项目根目录的
.vscode/settings.json里加这行："go.formatTool": "goimports" - 确保已装
goimports工具（上面“Install All”时它就在列表里） - 如果仍不生效，检查
go.mod是否存在——没有go.mod文件，goimports会退化成gofmt行为 - 别在用户级设置里全局开
editor.formatOnSave，不同项目依赖不同，容易冲突；优先放项目级.vscode/settings.json
调试跑不起来？重点查 dlv 版本和 launch.json
F5 启动调试时卡在 “Starting: dlv dap …” 或直接报错 Failed to launch: could not find Delve debugger，通常不是没装 dlv，而是版本或配置不对。
- 终端执行
dlv version，确认输出里有Delve Debugger字样且版本 ≥ 1.21.0（2026年主流Go 1.22+ 要求） - 项目根目录建
.vscode/launch.json，内容至少包含："program": "${workspaceFolder}"和"mode": "auto" - 如果用的是 Windows Subsystem for Linux (WSL)，
dlv必须装在 WSL 里，不是 Windows 主系统——VS Code Remote-WSL 模式下，插件调用的是 WSL 的二进制 - 调试前务必先
go mod init xxx初始化模块，否则dlv无法解析依赖路径
真正卡住人的，往往不是“不会配”，而是工具链版本错位、代理没生效、go.mod 缺失这三个点交叉发生。每次遇到问题，先盯住终端里那行具体错误，别凭感觉猜。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
