并发数在 run.concurrency 配置项中设置,是唯一生效入口,对应 GOMAXPROCS;不配置时默认为 CPU 逻辑核数,推荐本地设 4、CI 设 2、高配机≤物理核数×1.5。

并发数在哪设:run.concurrency 是唯一入口
golangci-lint 的并发控制只通过 run.concurrency 配置项生效,没有其他隐藏开关或环境变量能覆盖它。它直接对应 Go 运行时的 GOMAXPROCS,决定同时跑多少个 linter 实例。不配这个字段时,默认值是当前机器 CPU 逻辑核数——对 32 核服务器来说可能一下子拉满,反而拖慢 CI 或本地响应。
为什么设错并发数会导致检查变慢甚至失败
并发不是越高越好。常见问题包括:
-
run.concurrency: 0或负数 → 工具直接 panic,报错concurrency must be > 0 - 设得远超物理核数(比如 64 核机器配 128)→ 大量 goroutine 切换开销压垮内存,
timeout更容易触发 - 在 CI 环境(如 GitHub Actions 默认 2 核)仍用默认值 → OOM killed 或超时退出,日志里只显示
signal: killed,根本看不到具体 linter 错误 - 与
modules-download-mode: "readonly"冲突 → 并发高时模块缓存争抢加剧,报could not load export data
推荐值怎么选:按场景分三档
没有全局最优解,得看运行环境:
-
本地开发(笔记本/台式机):设为
concurrency: 4。够快、不卡 IDE、风扇不狂转 -
CI 流水线(GitHub Actions / GitLab CI):显式写死,比如
concurrency: 2。避免依赖动态探测,防止不同 runner 行为不一致 -
高配构建机(16+ 核):上限建议 ≤ 物理核数 × 1.5,例如 24 核机器设
concurrency: 32。再高收益递减,且易触发 Go module cache 锁竞争
配置示例(.golangci.yml 片段):
立即学习“go语言免费学习笔记(深入)”;
run: concurrency: 4 timeout: 3m modules-download-mode: "readonly"
IDE 里改并发数要绕过 UI 坑
GoLand 等 IDE 的图形设置里有「并发字段」,但填了不一定生效:
- 如果项目根目录存在
.golangci.yml且启用了use-config,IDE 会完全忽略界面里填的并发值 - VS Code 的 Go 插件根本不暴露并发配置项,必须靠配置文件
- GoLand 设置路径
Settings → Go → Static Analysis → Concurrency只在没配置文件时兜底,别当真
真正可靠的路径只有一条:把 run.concurrency 写进 .golangci.yml,并在所有环境(本地、CI、IDE)都显式指定 --config=.golangci.yml 启动。
最容易被忽略的是多 module 项目——每个 module 目录下都得有自己的一份 .golangci.yml,哪怕内容只差一个并发数。漏掉任意一个,那个 module 就走默认并发,可能突然卡住或超时。


















