Go语言技术文章
-
Go runtime/metrics.Read 不会让同一个指标随机改变类型。真正容易出现的错配来自未知名称返回 KindBad、按位置猜类型、复用 Sample 时元数据错位,以及并发读写同一份 Value。本文用 Kind 分派和安全复用边界说明如何修复。193 收藏 -
配置 Go comment.Printer.HeadingID 自定义文档标题锚点,区分 nil 默认策略与空串省略,并用预分配映射协调重复标题、目录链接和多次渲染。235 收藏 -
Golang · Go教程 | 3天前 | 标准库 · utf-8 · Go教程 · Go UTF-8 unicode/utf8 RuneError 字节缓冲区 EncodeRune ValidRune Unicode码点
Go 的 unicode/utf8.EncodeRune 不会为非法 rune 返回 error,而是把超范围值或代理区码点写成 RuneError 的 UTF-8 编码。本文结合 ValidRune、固定缓冲区和业务拒绝策略,说明怎样保留可预测结果。245 收藏 -
runtime/metrics.All 返回的是会随运行时演进的指标描述目录,不是固定数组。本文说明为什么不能把指标名称硬编码成数组下标,并给出按 Description.Name 筛选、按 Value.Kind 读取以及处理关键指标兼容边界的写法。177 收藏 -
介绍 runtime/trace.Log 的 category、message、context 与 WithRegion 的职责边界,用最小 Go 示例为执行追踪区域附加可筛选的键值信息。417 收藏 -
runtime/trace.StartRegion 返回的是一段同一 goroutine 内的追踪区间,必须调用 Region.End 标记结束;嵌套区域还要遵守内层先结束、外层后结束。本文用 defer、嵌套代码和跨 goroutine 误区说明如何正确配对。257 收藏 -
Golang · Go教程 | 3天前 | 标准库 · Go教程 · 工程实践 · Go runtime/trace 执行追踪 trace.Start trace.Stop IsEnabled 可选诊断
runtime/trace.IsEnabled 可以低成本观察当前追踪是否启用,但它返回的是 advisory 信息,不能当作并发锁或永久保证。本文区分 IsEnabled、trace.Start、trace.Stop 的职责,并给出在可选诊断路径中安全使用这个判断的 Go 示例。392 收藏 -
解释 trace.Log 的消息为何属于执行追踪而不会自动进入业务日志,区分类别、任务上下文和 slog Handler,并给出显式关联两种记录的代码。228 收藏 -
Golang · Go问答 | 3天前 | 标准库 · Go问答 · 问题排查 · Go defer bufio.Writer runtime/trace go tool trace trace.Stop 追踪文件
Go runtime/trace.Stop 会等待追踪写入完成,但追踪文件末尾仍可能因为外层 bufio.Writer 未 Flush、文件先 Close、os.Exit 跳过 defer 而缺少事件。本文用文件字节数和资源顺序拆开这三个边界,并给出可复用的关闭写法。481 收藏 -
runtime/trace.Start 会把追踪数据缓冲并写入目标 Writer,trace.Stop 只有在相关写入完成后才返回。本文解释为什么不能先关闭文件,给出 defer 的安全注册顺序,并梳理重复 Start、共享 Writer 与错误处理的边界。143 收藏 -
用 runtime/trace.Stop 等待追踪写入结束,说明 Stop、缓冲 Flush 与文件 Close 的职责,给出正常退出和错误返回时的资源收尾写法。174 收藏 -
go/types.Instantiate 用于把泛型 Alias、Named 或 Signature 与具体类型参数组合成实例。本文从参数数量、约束校验、Named 结果读取和 ArgumentError 定位四个角度,给出静态分析工具中更稳妥的调用方式。133 收藏 -
Go runtime/trace.FlightRecorder.Stop 只结束持续记录,并不会自动导出追踪文件;真正写入文件的是 WriteTo。本文解释 Stop、WriteTo、Enabled 与滑动窗口的关系,说明停止后写入为什么失败,并给出先导出再停止的安全调用顺序和并发处理方式。494 收藏 -
通过 comment.Parser 解析 Go 文档注释,遍历 Doc.Links 并依据 LinkDef.Used 筛出未使用定义,保留链接文字与 URL,区分引用状态和网址有效性。366 收藏 -
Go runtime/trace.FlightRecorder.Start 第二次调用不会覆盖已有 recorder,而是返回错误;真正改变故障采集策略的,往往是调用方忽略错误后转入普通 trace 或放弃写出。本文按生命周期拆解重复启动、Enabled、Stop、WriteTo 的关系,并给出唯一启动入口的处理方式。291 收藏