golangci-lint默认启用本地缓存，存储于~/.cache/golangci-lint（Linux/macOS）或%LOCALAPPDATA%\golangci-lint\Cache（Windows），运行golangci-lint cache status可确认是否生效。
缓存默认是否启用？怎么确认它在工作
golangci-lint 默认启用本地缓存，但只对当前用户、同一项目路径生效。它把分析结果存在 ~/.cache/golangci-lint（Linux/macOS）或 %LOCALAPPDATA%\golangci-lint\Cache（Windows）。运行 golangci-lint cache status 可查看缓存命中率和路径；若提示 “no cache found”，说明缓存未初始化或被清空。
为什么本地二次检查仍慢？常见缓存失效原因
缓存不是万能的，以下情况会强制跳过或重建缓存：
-
--fast模式下部分 linter（如goconst、gocyclo）被跳过，它们的缓存不参与本次构建，但不影响其他已启用 linter 的缓存复用 - 配置文件（
.golangci.yml）被修改，哪怕只改了一个空格，整个缓存 key 重算，旧缓存失效 - Go module 状态变化：比如
go.mod更新、replace路径变更、或go.work文件增删，都会导致 AST 解析上下文不同，缓存拒绝复用 -
golangci-lint 升级到新版本（如从 2.13 → 2.14），尤其涉及 facts 重载修复时，旧缓存可能被标记为不兼容 —— 官方不强制清除，但建议升级后首次运行加
--clear-cache
CI/CD 中如何共享和复用缓存
CI 环境中缓存默认是隔离的，需显式配置路径并确保跨 job 复用：
- 设环境变量：
GOLANGCI_LINT_CACHE=/tmp/golangci-cache（推荐用 tmpfs 或挂载卷，避免磁盘 IO 瓶颈） - 在 CI 步骤中先恢复缓存（如 GitHub Actions 的
actions/cache恢复/tmp/golangci-cache目录） - 运行命令时加
--timeout=2m防止卡死，且避免使用--fast（CI 需全量深度检查） - 注意：不要跳过
vendor/后再开缓存 —— vendor 内容变化也会影响缓存有效性，--skip-dirs vendor本身不破坏缓存逻辑，但若 vendor 实际被修改且未重新 vendor，linter 可能因解析失败退回到无缓存模式
什么时候该手动清缓存？
不是所有“变慢”都要清缓存。只有这些信号出现时才值得动手：
-
golangci-lint cache status显示 “miss rate > 80%” 且持续多个 commit - 升级 golangci-lint 后首次运行报错涉及
facts、type-checker或go/types相关 panic - 明明没改代码，但每次
run都耗时翻倍，且--debug输出里反复出现loading facts from disk: failed
清缓存只需一行：golangci-lint cache clean。别用 rm -rf ~/.cache/golangci-lint —— 它可能残留锁文件或损坏状态，官方命令会安全处理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
