go命令未找到需先检查PATH是否生效，macOS/Linux用which go验证，Windows用Get-Command go；模块模式需确保go.mod存在或执行go env -w GO111MODULE=on强制启用；golangci-lint默认仅启用govet和errcheck，必须配置.golangci.yml（与go.mod同级、命名严格）并显式启用staticcheck等核心linter，CI和VS Code中需手动指定配置路径及lint工具。
go 命令没找到，先确认 PATH 和模块模式
装完 Go 却执行 go version 报 command not found，90% 是 PATH 没生效。macOS/Linux 运行 which go，没输出就说明路径没加对；Windows 用 PowerShell 执行 Get-Command go，失败就得去系统环境变量里手动加 /usr/local/go/bin（macOS/Linux）或 C:\Program Files\Go\bin（Windows）。装完别急着配 linter，先确保 go mod init 能成功——删掉项目里的 vendor/ 目录，运行 go env -w GO111MODULE=on 强制启用模块模式，否则 go.mod 生成可能静默失败。
golangci-lint 安装后默认不干活
执行 golangci-lint --version 成功 ≠ 它开始检查代码。它默认只开 govet 和 errcheck，staticcheck、unused 这些真正揪逻辑 bug 的检查器全关着。不配 .golangci.yml 就等于白装。这个文件必须和 go.mod 在同一级目录，名字必须是 .golangci.yml（不是 .yaml 或 .golangci.yaml），也不能放在 src/ 或子目录里。多 module 项目（比如 monorepo）每个 module 都得单独放一份配置，根目录的配置不会继承下去。
CI 和 IDE 里配置容易失效
golangci-lint run 在 CI 或 VS Code 里没报错却漏检，大概率是配置没读进去。CI 脚本里必须显式加 --config=.golangci.yml，不能依赖自动发现；VS Code 的 Go 插件要手动打开设置项 go.lintTool，填 "golangci-lint"，再勾选「使用配置」并指定路径为 .golangci.yml，否则可能沿用旧缓存或默认规则。另外，CI 默认并发太高容易卡住，建议加 --concurrency=2 和 --timeout=2m，本地开发时加 --fast 可避免编辑器卡顿，但定期要去掉这个 flag 跑一次全量扫描。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
跳过检查不是为了绕坑，而是应对真实例外
生成代码、兼容性适配、benchmark 文件这些场景确实需要跳过。单行跳过写 //nolint:staticcheck（只禁用指定 linter），或 //nolint（禁用所有）；整个文件跳过，就在文件顶部第一行加 //nolint。别滥用 exclude-files 列表——它会彻底忽略文件，连 govet 都不跑，容易埋隐患。真正该关的只有像 dupl（重复代码）和 lll（行长限制）这类误报高、纯风格类的 linter，核心五项：govet、errcheck、staticcheck、unused、revive 必须保留。
立即学习“go语言免费学习笔记（深入）”；
