一、先搞懂:runtime.GOMAXPROCS 是什么
- 函数签名:
func GOMAXPROCS(n int) int - 作用:设置可并行执行 Go 代码的 OS 线程数上限(即 P 的数量),返回旧值;n<1 不修改。
- 默认值:runtime.NumCPU()(逻辑 CPU 核心数)。
- 误区:不是 goroutine 数量上限,只控制 "同时跑 Go 代码的线程数";goroutine 可成千上万个。
二、三种设置方法(启动时设最稳)
1. 代码硬编码(main/init 最开头)
go
运行
package main
import (
"runtime"
)
func init() {
runtime.GOMAXPROCS(2) // 设为 2 核
}
func main() {
// ...
}
2. 环境变量(推荐,不用改代码)
bash
运行
# Linux/macOS
export GOMAXPROCS=2
./your_app
# Windows
set GOMAXPROCS=2
your_app.exe
3. 容器 / 云原生:自动对齐 cgroup 限制(必用)
容器里默认取宿主机核数,会远超容器 CPU 限制(如容器限 1 核、宿主机 32 核 → GOMAXPROCS=32,导致频繁上下文切换、限流)。
方案:uber/automaxprocs(一行代码搞定)
go
运行
package main
// 匿名导入,init 自动设置
import _ "go.uber.org/automaxprocs"
func main() {
// 自动读取 cgroup CPU 限制并设 GOMAXPROCS
}
- 原理:启动时读取容器 CPU quota/period,自动设为
max(2, ceil(容器CPU限制))。 - 安装:
go get go.uber.org/automaxprocs
三、不同场景怎么调(核心结论)
1. 物理机 / 虚拟机(非容器)
- 默认(= 核数):大多数服务(HTTP、RPC、IO 密集)直接用默认,不用改。
- CPU 密集型 :可设为 核数 ±1(如 4 核设 3~5),不超过 2 倍核数,避免调度开销飙升。
- IO 密集型(大量 goroutine 阻塞) :设 2~4 足够,多了反而上下文切换多。
2. 容器 / K8s(最关键)
- 绝对不要用默认:必须对齐容器 CPU 限制。
- 规则:
- 容器限 0.5 核 → GOMAXPROCS=2
- 容器限 1 核 → GOMAXPROCS=2
- 容器限 2 核 → GOMAXPROCS=2
- 容器限 4 核 → GOMAXPROCS=4
- 直接用 automaxprocs,不用自己算。
3. 常见问题与处理
- CPU 打满但吞吐低:GOMAXPROCS 过高,上下文切换多 → 调低(如从 8→2)。
- 容器被限流(throttling):GOMAXPROCS > 容器限制 → 用 automaxprocs 对齐。
- GC 卡顿严重:GOMAXPROCS 过高,GC 线程竞争激烈 → 适当降低。
四、总结(一句话记住)
- runtime.GOMAXPROCS 控制并行线程数,默认等于 CPU 核数。
- 物理机 :默认或核数 ±1;IO 密集 :2~4;CPU 密集:核数附近。
- 容器 / K8s :必须用 automaxprocs,自动对齐 CPU 限制。