golangci-lint是go微服务静态检查唯一事实标准，必须配置.golangci.yml显式启用staticcheck、errcheck、gosec等关键检查项，并在ci中加--fast和--issues-exit-code=1确保构建失败卡点，go fmt仅做格式化，无法发现逻辑缺陷。
Go 微服务上线前不跑 golangci-lint，等于主动放行 goroutine 泄漏、空指针、SQL 连接未关闭等高危问题。
go fmt 只做格式，不做逻辑判断
go fmt 是 Go 官方唯一背书的格式化工具，它只改缩进、空格、括号换行、导入排序这些“看得见”的结构，不碰语义。比如：
- 它不会告诉你
fmt.Println("hello %s", name)里%s根本不生效（该用Printf） - 它不会发现
json:"name" json:"name"这种重复标签 - 它对
var x int后面完全没用，也视而不见
所以 go fmt 必须用，但仅靠它远远不够——它只是代码能“被读”的底线，不是“能跑稳”的保障。
golangci-lint 是微服务静态检查的事实标准
单独跑 govet、staticcheck 或旧版 golint 都会漏检或误报。真正适合微服务的方案是统一用 golangci-lint，原因很实际：
-
golint已归档，2021 年起不再维护，别再装它 -
govet默认不检查json.Unmarshal类型不匹配、time.After在循环中滥用等高频线上故障点 -
staticcheck单独运行时，常因模块路径或go.work环境报错，而golangci-lint自动适配模块模式
必须在 .golangci.yml 中显式启用关键检查项：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
enable: - staticcheck - errcheck - gosec disable: - golint - maligned - scopelint
否则默认配置下，staticcheck 实际是关着的。
CI 中 golangci-lint run 必须加参数才真正卡住质量
很多团队把 golangci-lint run 加进 CI 就以为万事大吉，结果构建永远成功，警告刷屏没人看。真实有效的做法是：
- 加
--fast：跳过缓存重建，避免 CI 变慢拖累迭代 - 加
--issues-exit-code=1：只要发现任何问题（哪怕只是命名警告），就让构建失败 - 加
--skip-dirs="testdata|_test"：避免在 mock 场景里误报sql.Rows未关闭
另外，gofmt -l . 和 golangci-lint run 应作为两个独立步骤，前者查“是否格式化”，后者查“是否写对”，不能混为一谈。
编辑器里自动修复 ≠ 代码质量达标
VS Code 或 GoLand 设置了 "editor.formatOnSave": true 和 "source.fixAll"，确实能自动修掉部分 revive 或 staticcheck 的低风险项（比如命名大小写）。但要注意：
- 自动修复不处理
for _, v := range items { go func() { fmt.Println(v) }() }这类变量复用问题——这是staticcheck的SA9003规则，必须人工改 - 它也不会补上你漏掉的
defer rows.Close()，这得靠errcheck和gosec联合识别 - 测试文件里的
http.HandlerFunc模拟逻辑，容易触发误报，要靠--skip-dirs或//nolint精确豁免，而不是全局关规则
真正的质量门槛不在保存那一刻，而在 PR 提交前、CI 运行时、以及每次 go run main.go 之前——这三个节点，缺一不可。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
