应设置全局timeout为8m并在ci中延长至10m，跳过vendor/generated目录，启用缓存；命令行--timeout参数优先级最高，可临时覆盖配置。
当你在CI流水线中运行golangci-lint时，遇到检查中途被强制终止、报错“timeout exceeded”或本地执行卡死在某个文件上，说明当前默认超时时间已不足以覆盖项目规模或特定linter的分析耗时。
在.golangci.yml中设置全局timeout
打开项目根目录下的.golangci.yml文件，在run段顶部直接写入timeout字段：
run:
timeout: 8m
concurrency: 6
这会将整个golangci-lint run命令的最长允许执行时间设为8分钟。注意单位必须是m（分钟）或s（秒），不支持min或seconds等拼写。
【timeout值过小会导致staticcheck、unused等重量级linter被粗暴中断，结果不可靠】
临时覆盖timeout：命令行参数优先级最高
方法一：在终端中直接追加--timeout参数
golangci-lint run --timeout=12m
方法二：对单个子命令提速，比如只检查当前修改文件
git ls-files -m | grep '\.go$' | xargs golangci-lint run --timeout=90s --fix
命令行传入的--timeout会完全覆盖配置文件中的设定，且无需重启IDE或重载配置。
CI环境中的timeout适配策略
第一步：确认CI runner资源上限
GitHub Actions默认ubuntu-latest的内存约7GB，CPU为2核；若项目含大量generated代码或vendor，5m timeout极易触发中断。
第二步：在workflow中显式延长超时并跳过重灾区
jobs:
lint:
steps:
- name: Run golangci-lint
uses: golangci/golangci-lint-action@v3
with:
version: v1.54.2
args: --timeout=10m --skip-dirs vendor,generated,testdata
第三步：启用缓存避免重复解析依赖树
添加GOLANGCI_LINT_CACHE环境变量指向持久化路径，否则每次都会从零构建AST缓存，实测可降低40%以上耗时。
跳过vendor和generated是硬性要求，否则staticcheck会在protobuf生成代码里持续报错并拖垮超时计时器。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
