Go开发环境需重点安装gopls、goimports、golangci-lint、dlv、gotests这5个工具，配置go.useLanguageServer为true、go.formatTool为goimports、启用自动导入整理，并通过GOPROXY和GOSUMDB确保模块下载与校验正常。
Go 环境能跑起来，不等于开发体验好；很多问题不是出在 go version 能否执行，而是卡在 go get 失败、dlv 启动不了、结构体标签手敲漏逗号、测试用例改了却没刷新——这些才是真实开发里每天要踩的坑。
go install 工具链失败：别全选，先装这 5 个
VS Code 的 Go: Install/Update Tools 默认勾选全部 18 个工具，但实际项目中真正高频使用且容易因网络/权限失败的只有几个。全装不仅耗时，还可能因某个工具失败导致整个流程中断，后续再想单独重装反而更麻烦。
-
gopls（必须）：语言服务器核心，补全、跳转、诊断都靠它；"go.useLanguageServer": true必须开启 -
goimports（必须）：替代gofmt，自动整理 import 顺序，尤其适配国内团队对git.code.oa.com等私有路径的导入规范 -
golangci-lint（推荐）：静态检查主力，比默认golint更准、更可配；配合"go.lintTool": "golangci-lint"使用 -
dlv（调试必需）：VS Code 调试器底层依赖，没它就点不了断点；安装后确认dlv version可执行 -
gotests（提效关键）：右键生成测试函数，支持-all和-only模式，避免手动写TestXXX拼错名
其余如 gurugorename 等已基本被 gopls 覆盖，可暂缓安装；若某工具报错，直接在终端运行 go install -v github.com/uudashr/gopkgs/v2/cmd/gopkgs@latest 单独重试，比 GUI 重装更可控。
代理和 GOPROXY 不生效？检查这三个地方
设置了 GOPROXY 却依然提示 cannot find module providing package，大概率是环境变量没进 Go 进程上下文，或被其他配置覆盖。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（Windows 用setx或 PowerShell$env:GOPROXY="https://goproxy.cn,direct"），确保写入的是用户级环境变量，而非仅当前终端 - 检查
go env GOSUMDB，若为off或空，可能导致校验失败；建议设为go env -w GOSUMDB=off（开发阶段）或sum.golang.org（生产） - VS Code 集成终端有时不继承系统环境变量，可在
settings.json中加："terminal.integrated.env.windows": {"GOPROXY": "https://goproxy.cn,direct"}
验证方式：新建空白目录，执行 go mod init testmod && go get github.com/sirupsen/logrus，成功即说明代理通路正常。
VS Code 插件配置别只开默认：这几个 setting.json 必调
官方 Go 插件默认配置偏保守，不开某些开关，你会反复遇到“跳转不到定义”“import 不自动补全”“保存后格式化失效”等问题。
-
"go.autocompleteUnimportedPackages": true：否则输入http.时不会提示http.NewRequest等未导入包的符号 -
"go.formatTool": "goimports"：不用gofmt，否则 import 分组混乱，团队协作易冲突 -
"go.testFlags": ["-v", "-count=1"]：避免go test缓存结果，改完代码立刻看到最新输出 -
"editor.codeActionsOnSave": {"source.organizeImports": true}：配合goimports，保存即整理 import，省去手动操作
注意：go.lintFlags 若设为 ["--fast"]，会跳过部分深度检查（如循环引用），适合大型项目提速，但 CI 阶段建议去掉该 flag 做全量扫描。
结构体标签写错、JSON 解析失败？用插件而不是手敲
手写 json:"user_id,omitempty" db:"user_id" 极易漏引号、拼错字段名、混淆 omitempty 位置，导致序列化为空或数据库写入失败，这类错误 runtime 才暴露，排查成本高。
- 装
Go Struct Tag插件，光标停在字段上，Ctrl+Shift+P→Go: Generate Struct Tags，选json、gorm等，自动生成标准格式 - 字段名含下划线（如
user_name）时，插件默认转为驼峰UserName，若需保持原样，提前在插件设置里关掉"goStructTag.camelCase": false - 生成后务必检查是否覆盖了已有标签——插件默认会替换整行，已有
db标签会被清掉，建议先备份或用多光标编辑补全
真正麻烦的不是写错一次，而是不同服务间 struct 标签风格不一致（有的用 json:"id"，有的用 json:"ID"），导致 API 兼容性断裂；统一用插件生成，是团队落地规范最轻量的方式。
