结论是只需配置golangci-lint+go vet；VS Code中启用go.useLanguageServer和go.lintTool指向golangci-lint，即可实现高效静态分析，其中govet查基础语义错误、errcheck抓未处理error、staticcheck做深度语义分析，全部由golangci-lint统一调度。
直接上结论：别装一堆独立 linter，只配 golangci-lint + go vet 就够了；VS Code 里开 go.lintTool 指向它，再补一条 go.useLanguageServer true，静态分析就跑起来了。
gopls 本身不负责深度语义检查，它只提供基础 LSP 能力（跳转、补全、格式化），真正抓 bug 的是背后调度的 linter。手动装 staticcheck、errcheck 单独二进制，反而容易版本错乱、PATH 漏配、规则冲突。
为什么必须用 golangci-lint 而不是单个工具？
它不是“可选项之一”，而是 Go 生态当前唯一能统一纳管所有关键检查器的入口——govet、errcheck、staticcheck、unused 全部并行跑，输出归一，配置集中。golint 已归档，禁用；revive 可选但非必需，风格类检查优先交给 goimports 和 gofumpt。
-
govet是地基：Go SDK 自带，500ms 扫完项目，专查fmt.Printf("%s", 42)、json:"name"写在小写字段上、sync.WaitGroup传值不传址这类 runtime panic 前兆 -
errcheck是刚需：Go 最常见隐患——忽略 error 返回值，os.Open(...); defer f.Close()这种写法没报错但逻辑残缺，它立刻标红 -
staticcheck是深度眼：查死代码、无效类型断言、SA1019（弃用 API）、SA9003（无用 return），但它必须在go.mod目录下运行，单独执行会报no Go files in directory
VS Code 中怎么让 lint 结果实时显示？
确认已安装官方 Go 扩展（作者 Google），然后在 settings.json 里加这三行：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
"go.useLanguageServer": true, "go.lintTool": "golangci-lint", "editor.formatOnSave": true
不用重启，保存 .go 文件后波浪线就出来了。悬停提示里会明确写清是 errcheck 还是 staticcheck 哪条规则触发的，不是笼统“语法错误”。
- 如果编辑器不报错，先运行
golangci-lint run看终端是否真有输出——没输出说明.golangci.yml没生效或路径不对 - 报
command not found: golangci-lint？检查$(go env GOPATH)/bin是否在$PATH，macOS 用户尤其注意~/.zshrc里有没有export PATH="$GOPATH/bin:$PATH" - 误报太多？别急着关 linter，先看是不是在模板层（如 html/template）触发了
SA1006（未用 fmt 参数），这种场景建议局部禁用：//nolint:staticcheck
项目根目录必须有 .golangci.yml 吗？
必须。默认配置只启用保守子集，漏掉 errcheck 和大部分 staticcheck 规则。最小可用配置长这样：
run:
timeout: 3m
skip-dirs:
- vendor
- testdata
<p>linters-settings:
errcheck:
check-type-assertions: true
staticcheck:
checks: ["all"]</p><p>linters:
enable:</p><ul><li>errcheck</li><li>staticcheck</li><li>govet</li><li>unused
disable:</li><li>golint重点：disable: golint 这行不能少，否则大量主观风格警告干扰判断；skip-dirs 不写的话，vendor/ 里的第三方代码也会被扫，拖慢速度还报一堆无关问题。
- 生成命令
golangci-lint init会建空文件，但内容太松，得手动补上面这几项 - CI 里跑
golangci-lint run --out-format=github-actions，失败自动阻断 PR，比本地配置更重要 - 第一次运行慢是正常的——
staticcheck在构建类型图谱，后续缓存快很多
最常被忽略的点：go vet 不是可选项，是每行代码提交前该手动补跑的一道快速过滤器。哪怕 golangci-lint 已集成它，改完核心逻辑后，顺手敲一句 go vet -tags=dev ./...，能立刻暴露那些 golangci-lint 默认没开的检查项（比如 unmarshal、shadow）。
