Go runtime 怎样读取 GOMAXPROCS 当前值

如果只是想知道 Go 进程当前允许多少个处理器并行执行用户级 Go 代码，不需要读取环境变量或推测机器 CPU 数量，直接调用 runtime.GOMAXPROCS(0) 即可。参数小于 1 时，函数只返回当前设置，不会修改它。

一句话结论：runtime.GOMAXPROCS(0) 是读取当前 GOMAXPROCS 的最小写法；不要用 runtime.NumCPU() 代替，因为两者描述的对象不同。

官方文档：https://pkg.go.dev/runtime#GOMAXPROCS

用 GOMAXPROCS(0) 读取当前值

GOMAXPROCS 控制可以同时执行用户级 Go 代码的操作系统线程数量。读取当前值时传入 0，返回值就是此刻运行时使用的上限：

package main

import (
	"fmt"
	"runtime"
)

func main() {
	// 传入 0 表示只查询，不修改当前 GOMAXPROCS。
	current := runtime.GOMAXPROCS(0)
	fmt.Printf("当前 GOMAXPROCS=%d\n", current)
}

这个调用适合放在启动日志、诊断信息或调试接口中。它返回的是运行时当前设置，而不是“机器上有几颗 CPU”。因此，在容器、CPU 亲和性或手动配置存在时，返回值可能与 runtime.NumCPU() 不同。

为什么参数小于 1 只读取不修改

同一个函数也支持修改设置：传入大于等于 1 的整数会尝试把上限改为该值，并返回修改前的设置。传入小于 1 的整数则不会发生修改，这正是查询写法安全的原因：

package main

import (
	"fmt"
	"runtime"
)

func main() {
	// 小于 1 的参数只查询当前值，不改变调度器配置。
	before := runtime.GOMAXPROCS(0)
	// 大于等于 1 才是修改语义；返回值是修改前的值。
	previous := runtime.GOMAXPROCS(2)
	// 再次查询，用于观察修改后的当前值。
	after := runtime.GOMAXPROCS(0)
	fmt.Println("before:", before, "previous:", previous, "after:", after)
}

如果代码只负责展示状态，不要为了“顺便校正”而调用 runtime.GOMAXPROCS(1) 或其他正数。那会改变进程的调度配置，也会让后续代码看到不同的并行上限。读取和修改最好分成两个命名清晰的函数，减少调用方误用。

不要把当前值和默认值来源混为一谈

runtime.GOMAXPROCS(0) 告诉你结果是多少，但不告诉你这个结果是如何被设置的。没有手动覆盖时，运行时会综合逻辑 CPU 数量、进程 CPU 亲和性；在较新的 Go 版本和 Linux cgroup 环境中，还会考虑 CPU 吞吐限制。设置了 GOMAXPROCS 环境变量，或代码主动调用过 GOMAXPROCS(n)，则自动更新行为会受到影响。

因此，诊断日志可以同时记录当前值和明确的配置来源，而不要根据一个整数反推部署环境：

package main

import (
	"log"
	"os"
	"runtime"
)

func logParallelism() {
	// 当前值由运行时统一计算，日志只观察，不主动修改。
	current := runtime.GOMAXPROCS(0)
	// 环境变量仅作为可见线索，空值表示没有从环境显式读取到配置。
	configured := os.Getenv("GOMAXPROCS")
	log.Printf("GOMAXPROCS=%d, env=%q", current, configured)
}

func main() {
	// 在服务启动阶段记录一次，便于结合部署配置排查并发差异。
	logParallelism()
}

把读取结果放进启动诊断

实际项目里，最稳妥的做法是把读取封装成无副作用的诊断函数，并在启动日志中输出。这样既不会改变调度策略，也能让排查人员把当前并行上限和部署限制放在一起比较：

package runtimeinfo

import (
	"fmt"
	"runtime"
)

func Summary() string {
	// 只调用查询形式，避免诊断代码改变业务进程的运行时配置。
	return fmt.Sprintf("GOMAXPROCS=%d", runtime.GOMAXPROCS(0))
}

需要注意，GOMAXPROCS 只限制同时执行用户级 Go 代码的数量，阻塞在系统调用中的线程并不简单等同于这个数。它也不是吞吐量保证值；是否需要调整，应结合任务类型、容器限制和实际指标判断。

常见问题

为什么不直接用 runtime.NumCPU？

NumCPU 描述可见的逻辑 CPU 数量，GOMAXPROCS(0) 描述调度器当前采用的并行上限。容器或亲和性配置存在时，两个结果可能不同。

调用 GOMAXPROCS(0) 会改变并发行为吗？

不会。根据 runtime 文档，小于 1 的参数不改变当前设置；查询调用本身只返回当前值。

怎样恢复运行时默认值？

如果使用的是支持该能力的 Go 版本，可以查看 runtime.SetDefaultGOMAXPROCS；它用于恢复运行时默认值。若只需要观察状态，仍然使用 runtime.GOMAXPROCS(0)，不要在诊断函数里主动恢复或修改。

小结

读取 Go 当前 GOMAXPROCS 的核心只有一行：runtime.GOMAXPROCS(0)。记住三点即可：小于 1 的参数只读；正数参数会修改并返回旧值；当前值不等于逻辑 CPU 数量。把查询调用放进启动诊断，就能在不改变调度策略的前提下看清进程实际使用的并行上限。