-
runtime/metrics.All 返回的是会随运行时演进的指标描述目录,不是固定数组。本文说明为什么不能把指标名称硬编码成数组下标,并给出按 Description.Name 筛选、按 Value.Kind 读取以及处理关键指标兼容边界的写法。
-
runtime/trace.StartRegion 返回的是一段同一 goroutine 内的追踪区间,必须调用 Region.End 标记结束;嵌套区域还要遵守内层先结束、外层后结束。本文用 defer、嵌套代码和跨 goroutine 误区说明如何正确配对。
-
解释 trace.Log 的消息为何属于执行追踪而不会自动进入业务日志,区分类别、任务上下文和 slog Handler,并给出显式关联两种记录的代码。
-
Go runtime/trace.Stop 会等待追踪写入完成,但追踪文件末尾仍可能因为外层 bufio.Writer 未 Flush、文件先 Close、os.Exit 跳过 defer 而缺少事件。本文用文件字节数和资源顺序拆开这三个边界,并给出可复用的关闭写法。
-
runtime/trace.Start 会把追踪数据缓冲并写入目标 Writer,trace.Stop 只有在相关写入完成后才返回。本文解释为什么不能先关闭文件,给出 defer 的安全注册顺序,并梳理重复 Start、共享 Writer 与错误处理的边界。
-
Go runtime/trace.FlightRecorder.Stop 只结束持续记录,并不会自动导出追踪文件;真正写入文件的是 WriteTo。本文解释 Stop、WriteTo、Enabled 与滑动窗口的关系,说明停止后写入为什么失败,并给出先导出再停止的安全调用顺序和并发处理方式。
-
Go runtime/trace.FlightRecorder.Start 第二次调用不会覆盖已有 recorder,而是返回错误;真正改变故障采集策略的,往往是调用方忽略错误后转入普通 trace 或放弃写出。本文按生命周期拆解重复启动、Enabled、Stop、WriteTo 的关系,并给出唯一启动入口的处理方式。
-
Go runtime/trace.FlightRecorder.WriteTo 返回的 n 是本次写出过程中累计的字节数,不是 MaxBytes,也不是固定预估值。本文拆解移动窗口、追踪头部、批次写入与 error 的关系,并给出处理部分写出和并发调用的 Go 示例。
-
Go go/types.LookupFieldOrMethod 返回 obj=nil、indirect=true 时,通常是指针接收者方法存在,但当前接收值不可寻址且没有指针路径。本文拆解 addressable 参数、方法集和三个返回值的关系,并给出静态分析中的分类处理方式。
-
synctest.Wait 等待的是 bubble 内其他 goroutine 进入可持久阻塞或完成,不会替测试触发气泡外事件。本文用最小示例说明读不到状态的原因与修复顺序。
-
testing/synctest.Test 把并发测试放进隔离气泡,并为每个气泡提供独立的虚拟时钟。本文用最小示例解释为什么 time.Sleep(2秒) 不会让测试真的等待两秒,以及 synctest.Wait、synctest.Sleep 和外部 I/O 在时间推进上的区别。
-
Go 的 ed25519.Options.Hash 不是一个普通的摘要配置,而是用来选择 Ed25519 或 Ed25519ph。本文结合 Sign、VerifyWithOptions 和 Context 的关系,说明消息何时应先做 SHA-512,以及迁移时最容易踩到的模式不匹配问题。
-
runtime.GOMAXPROCS 限制的是同时执行用户态 Go 代码的并行度,不是 goroutine 的创建数量。本文区分逻辑 CPU、GOMAXPROCS 与 NumGoroutine,并说明容器默认值和手工设置的边界。
-
Go image/draw.Draw 可以把 Gray、RGBA、NRGBA 或调色板图像绘制到另一种颜色模型的目标图上。本文说明 r 与 sp 的对齐关系、目标模型的转换边界,以及 Over 和 Src 在透明度场景中的选择。
-
Go math/big.Int.Not 得到负数不是溢出,而是有符号任意精度整数按 ^x = -x - 1 计算的结果。本文对比 uint 固定宽度取反,并用 2^N-1 掩码演示如何得到协议字段所需的 N 位结果。