runtime.NumGoroutine() 返回当前活跃协程数而非系统线程数，统计 running、runnable、waiting 状态的 goroutine，不包含已退出或被 GC 回收的，且无法区分用户与 runtime 内部 goroutine。
runtime.NumGoroutine() 返回的是当前活跃协程数，不是系统线程数
很多人误以为 runtime.NumGoroutine() 能反映系统负载，其实它只统计当前 goroutine 状态机中处于 running、runnable、waiting（如 channel 阻塞、syscall 等）的总数，不包含已退出或被 GC 回收的。它和 OS 线程（M）数量无直接对应关系。
实际使用时要注意：
- 该值在高并发短生命周期 goroutine 场景下抖动剧烈，不适合做阈值告警的唯一依据
- 若看到数值持续 > 10k，应结合
pprof/goroutine?debug=2查看阻塞点，而非直接认为“系统卡了” - 它无法区分用户逻辑 goroutine 和 runtime 内部 goroutine（比如
timerProc、sysmon）
用 runtime.ReadMemStats() 获取内存快照要记得先调用 runtime.GC()
runtime.ReadMemStats() 返回的是上次 GC 后的内存统计，不是实时堆占用。如果你刚分配大量对象但尚未触发 GC，MemStats.Alloc 和 HeapAlloc 可能远低于真实压力。
可靠做法是手动触发一次 GC 并等待完成：
立即学习“go语言免费学习笔记（深入）”；
runtime.GC()
time.Sleep(time.Millisecond) // 让 GC goroutine 实际执行完
var m runtime.MemStats
runtime.ReadMemStats(&m)
fmt.Printf("alloc = %v KB", m.Alloc/1024)
注意：
-
runtime.GC()是阻塞调用，生产环境慎用；调试或健康检查接口中可接受 -
MemStats.BySize中的桶大小是固定分段（如 8B/16B/32B…），不能反推具体对象类型 -
StackInuse和StackSys不含 goroutine 栈的虚拟地址空间开销，仅统计已提交的物理内存
runtime.GOMAXPROCS(0) 返回当前设置，但不等于可用 CPU 核心数
runtime.GOMAXPROCS(0) 读取的是当前 GOMAXPROCS 值，这个值默认等于 NumCPU()，但可能被 GOMAXPROCS=1 环境变量或代码中显式修改过。它控制的是 P（Processor）的数量，即最多有多少个 M 可以并行运行 G。
关键区别：
-
runtime.NumCPU()读取的是操作系统报告的逻辑核心数（/proc/cpuinfo或sysctl hw.ncpu），不受 Go 程序控制 - 容器环境中（如 Docker/K8s），
NumCPU()仍返回宿主机总核数，不是cgroups cpu quota限制值 - 若程序运行在
cpuset限制下，需额外解析/sys/fs/cgroup/cpuset/cpuset.effective_cpus才能得到真实可用核数
获取 Go 运行时版本和构建信息要用 runtime.Version() + debug.BuildInfo
runtime.Version() 只返回 Go 编译器版本（如 go1.22.3），不包含模块名、修订哈希或编译时间。真正需要发布级元数据时，必须用 debug.ReadBuildInfo()：
if info, ok := debug.ReadBuildInfo(); ok {
fmt.Println("go version:", info.GoVersion)
fmt.Println("main module:", info.Main.Path)
for _, dep := range info.Deps {
if dep.Name == "github.com/sirupsen/logrus" {
fmt.Println("logrus version:", dep.Version)
}
}
}
注意：
- 该信息仅在使用
go build -buildmode=exe且未 strip 的二进制中存在；CGO disabled 或 ldflags -s/-w 会丢失 -
info.Main.Version为空字符串表示未用go mod构建或未打 tag - 运行时无法获取
GOOS/GOARCH，它们属于编译期常量，需在构建时注入（如通过-ldflags "-X main.arch=$GOARCH"）
真正难的是把 runtime 数据和系统层指标对齐——比如 MemStats.Sys 包含 mmap 内存，但 ps aux 的 RSS 不包含匿名映射未触及的页；这类偏差不深挖 cgroup v2 memory.stat 就容易误判。
