装完golangci-lint不等于静态检查生效——默认仅启用govet和errcheck，staticcheck、unused等关键检查器必须通过同级go.mod目录下的.golangci.yml显式启用；多module项目需每个module单独配置，CI和IDE中均须显式指定--config=.golangci.yml才生效。
装完 golangci-lint 不等于静态检查就生效了——它默认只开 govet 和 errcheck，staticcheck、unused 这些真正能揪出 bug 的检查器全关着，不配 .golangci.yml 就等于没装。
golangci-lint 命令找不到或版本报错
常见现象：command not found: golangci-lint，或 golangci-lint --version 报错。
- 确认
$(go env GOPATH)/bin在$PATH中：macOS 用户用 zsh 时，检查~/.zshrc是否有export PATH="$GOPATH/bin:$PATH"，改完记得source ~/.zshrc - 别用 Homebrew 装（尤其 VS Code GUI 启动时读不到
/opt/homebrew/bin）：改用官方二进制脚本安装curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2 - VS Code 里仍报找不到？在设置中显式填
go.golangcilintPath，值为完整路径，例如/Users/you/go/bin/golangci-lint
.golangci.yml 放哪、叫啥名、怎么写才管用
常见错误：文件名写成 .golangci.yaml、golangci.yml 或 .golangci.yml.bak；或扔在项目根目录，但 go.mod 实际在 src/ 子目录里。
- 文件必须严格叫
.golangci.yml，且与go.mod在同一级目录 - 多 module 项目（如 monorepo）中，每个 module 目录下都要单独放一份，父目录配置不继承
- 最小可行配置示例（启用核心五项）：
run: timeout: 5m skip-dirs: - "vendor" - "testdata" linters-settings: errcheck: check-type-assertions: true staticcheck: checks: ["all"] linters: enable: - "govet" - "errcheck" - "staticcheck" - "unused" - "revive"
CI 或本地 run 时不读配置、检查项没效果
现象：golangci-lint run 看起来跑成功了，但该报的 unused 没报，staticcheck 的 SA 规则也沉默。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
立即学习“go语言免费学习笔记（深入）”；
-
golangci-lint run默认会尝试找配置，但 CI 容器环境常因工作目录或缓存问题漏读——必须显式加参数：golangci-lint run --config=.golangci.yml - VS Code 或 GoLand 也要在 IDE 设置里勾选「使用配置」并填对路径，否则插件可能沿用旧缓存或内置默认规则
- 改了
.golangci.yml没反应？重启语言服务器（VS Code：Cmd+Shift+P → Developer: Reload Window） - 想验证是否真加载了配置？加
--debug参数运行，输出里会显示 loaded config path
刚配置完就爆依赖错误：cannot find module providing package
现象：一执行 golangci-lint run 就报 cannot find module providing package github.com/xxx/yyy，不是 lint 工具坏了，是它严格按 go.mod 解析依赖。
- 先确保项目能正常
go build或go list -m all，lint 不会比编译器更宽容 - 如果
go.mod里有replace指向本地路径，确认那个路径存在且含有效go.mod - 临时调试可加
--no-config跳过配置加载，看是否是某 linter 插件触发了额外 import - CI 中遇到类似问题，加
go mod download步骤前置，避免 lint 阶段首次解析失败
最常被忽略的一点：golangci-lint 是质量门禁，不是学习工具。新手直接启用 unused 和 errcheck 会被大量警告淹没，掩盖真正该练的语法和流程——先让代码跑起来、有测试、模块清晰，再上这套检查机制。
