golangci-lint 缓存默认开启，无需额外配置；v1.50+ 内置基于文件内容哈希的缓存机制，自动跳过未变更文件分析，路径默认为 $XDG_CACHE_HOME/golangci-lint（Linux/macOS）或 %LocalAppData%\golangci-lint（Windows）。
golangci-lint 缓存默认是否开启
默认开启，无需额外配置。golangci-lint 从 v1.50+ 起内置基于文件内容哈希的缓存机制，自动跳过未变更文件的重复分析，显著加速后续 golangci-lint run 执行。缓存路径默认为 $XDG_CACHE_HOME/golangci-lint（Linux/macOS）或 %LocalAppData%\golangci-lint（Windows），不依赖项目目录。
如何查看和清理缓存
缓存状态不可视化显示，但可通过命令间接验证或强制刷新：
-
golangci-lint cache status：输出缓存命中/未命中统计（仅限 v1.53+） -
golangci-lint cache clean：清空全部缓存，适合 CI 环境或怀疑缓存损坏时使用 -
golangci-lint run --no-cache：单次禁用缓存，用于调试或比对结果差异
注意：cache clean 不影响已加载的 Go 模块缓存（$GOMODCACHE）或构建缓存（$GOCACHE），它们是独立系统。
CI 中缓存 golangci-lint 的关键点
在 GitLab CI 或 GitHub Actions 中，仅缓存 golangci-lint 自身二进制文件不够，必须持久化其分析缓存才能真正提速：
- GitLab CI：在
.gitlab-ci.yml中声明缓存路径cache: paths: - .cache/golangci-lint，并设置环境变量GOLANGCI_LINT_CACHE=.cache/golangci-lint - GitHub Actions：用
actions/cache缓存~/.cache/golangci-lint目录，key 建议包含golangci-lint-version和go-version - 避免将缓存挂载到容器只读层——会导致写入失败、静默退化为无缓存运行
如果跳过这一步，每次 CI job 都从零构建缓存，大型项目可能多耗 2–5 秒，且失去增量分析优势。
缓存失效的常见触发条件
以下任一变更都会使相关文件缓存失效，触发重新分析：
- 源文件内容修改（包括注释、空行、格式）
-
.golangci.yml中任意 linter 配置变更（如linters-settings.gocyclo.min-complexity改动） - Go 版本切换（
run.go: "1.21"→"1.22"） - 启用/禁用 linter（
linters.enable列表变化）
特别注意：skip-dirs 或 skip-files 变更不会导致已缓存文件重新分析，但会影响下次扫描范围——也就是说，被新规则排除的文件，其旧缓存仍存在但不再读取。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
