-
Go math/big.Rat.FloatString 用 prec 控制小数点后的位数,结果不足会补零,最后一位按最近舍入且半数远离零。本文说明如何保存精确 Rat、理解负数边界,并把外部位数限制放在格式化层。
-
用 go/build.Default 读取 Context.ToolTags,区分工具链标签、构建标签和发布标签,并说明复制默认 Context 后分析 MatchFile 的安全边界。
-
Go encoding/asn1.RawValue 可以接住暂不解析的 ASN.1 对象。本文用 DER 字节拆开 Class、Tag、Bytes 与 FullBytes 的关系,说明怎样原样透传未知字段、什么时候必须重建 RawValue,以及它和 RawContent 的使用边界。
-
Go os.DirFS 把操作系统目录包装成 io/fs.FS,调用方用相对路径读取根目录下的文件。本文用一个小例子说明 fs.ReadFile、fs.ReadDir、io/fs.Sub 的关系,并解释绝对根、相对根和符号链接的访问边界。
-
Go net/url.PathEscape 用于编码 URL 中的单个路径片段。本文用带空格、加号和斜杠的资源标识说明为什么斜杠会被编码,配合 url.JoinPath 组装多级路径,并对比 QueryEscape 和 PathUnescape 的适用边界。
-
Go 的 time.Duration.String 会把纳秒数转换成适合阅读的耗时文本:零值输出 0s,亚秒值自动选择 ns、µs 或 ms,较长耗时按 h、m、s 组合显示。本文说明它的输出规则、负数边界,以及与数值转换方法的区别。
-
Go slog.Record.AddAttrs 适合在自定义 Handler 或日志中间层里一次追加多个结构化字段。本文用请求 ID、模块名和租户标识说明它与 Add、Logger.With 的区别,并强调修改 Record 前先 Clone 的共享状态边界。
-
Go bytes.Buffer.ReadRune 按 UTF-8 字符读取缓冲内容,并返回 rune、实际字节数和错误。本文说明三返回值的含义、空缓冲与非法字节的处理,以及它和 ReadByte 的选择边界。
-
Go 使用 encoding/csv 导出文件时,Write 返回 nil 不等于目标 writer 已经完整写入。本文按 Write、Flush、Writer.Error 的职责拆开说明正确检查顺序,并对比 WriteAll 与文件导出的处理方式,避免把缓冲阶段的失败误判为成功。
-
用 Go encoding/binary 的 ByteOrder.Uint32 读取固定宽度二进制字段,重点说明 BigEndian、LittleEndian、字段偏移、四字节长度检查和短切片排查方法。
-
Go 的 bytes.Reader 可以在读取字节后用 UnreadByte 把游标回退一个字节,适合先检查前缀再交给后续解析逻辑。本文说明 ReadByte、UnreadByte 的位置变化、起始位置错误,以及它和 UnreadRune、Seek 的区别。
-
Go 1.21 起,reflect.Value.Clear 可以统一清空反射拿到的 map 或 slice:map 删除全部键值,slice 把现有元素置为零值。本文从常见故障现场出发,讲清 Kind、CanSet、nil、长度与版本边界的区别。
-
Go 读取带说明行的 CSV 配置时,可以给 csv.Reader 设置 Comment,让行首直接出现注释符的记录自动跳过。本文说明前导空白、空行、字段数量和 Read 循环之间的边界,避免把 TrimLeadingSpace 误当成注释开关。
-
Go debug/pe 中,pe.Open 创建的 File 应由 File.Close 收口;pe.NewFile 只包装传入的 io.ReaderAt,File.Close 对它没有关闭效果,底层文件仍由调用方负责。本文用两个最小示例拆清两条资源生命周期。
-
Go 处理上传缓冲区或内存中的 ZIP 数据时,可以用 bytes.NewReader 提供 io.ReaderAt,再把字节长度传给 zip.NewReader。本文说明如何遍历条目、读取内容、关闭句柄,并对比 os.File 作为 ReaderAt 时的资源边界。