-
Go binary.PutVarint 的关键不是把 int64 固定写成 8 字节,而是预留 MaxVarintLen64 容量并用返回长度截取有效结果。本文拆解负数编码、buf[:n] 和底层 Writer 的边界。
-
Go 的 net/mail.ParseDate 面向 RFC 5322 日期头,成功后返回带原始数值时区偏移的 time.Time。本文从单个 Date 字符串、完整邮件头、错误处理和业务时区转换四个角度说明如何使用。
-
Go 的 strconv.AppendQuote 会把字符串按 Go 字符串字面量规则转义并追加到 []byte。本文说明如何接住返回值复用目标切片,怎样批量追加,以及它与 Quote、ASCII 版本和 JSON 编码之间的边界。
-
Go 的 crypto.Hash 是哈希算法标识,Hash.New 才会创建本次计算使用的 hash.Hash 状态对象。本文用 SHA-256 说明 Available、New、分段 Write、Sum、Reset 的关系,并解释未链接算法直接调用 New 为什么会 panic。
-
Go encoding/hex 的 Dump 适合一次性生成十六进制转储,Dumper 则把分段 Write 的二进制数据持续写成接近 hexdump -C 的可读格式。本文说明 Write、Close、半行补齐和错误处理的责任边界。
-
Go types.Config.Check 会把同一个 package 的多个 ast.File 作为一个包检查,文件列表顺序不会改变跨文件声明的可见性;但共用的 token.FileSet 会影响源位置、诊断和源顺序相关输出。本文给出稳定解析多文件、配置 types.Info 与处理 InitOrder 的接入方法。
-
go doc 默认遵守 Go 的导出规则,只展示公开文档。本文区分 -all、-u、-src 和 -cmd 的职责,帮助定位未导出符号、包路径和命令包展示边界。
-
Go bytes.Buffer.ReadRune 按 UTF-8 字符读取缓冲内容,并返回 rune、实际字节数和错误。本文说明三返回值的含义、空缓冲与非法字节的处理,以及它和 ReadByte 的选择边界。
-
用 Go go/types.NewChan 构造只接收通道的类型信息,说明 ChanDir 与元素 Type 的关系,演示如何通过 Dir 和 Elem 读取方向与元素类型,并区分 *types.Chan 和运行时 make(chan T) 的用途边界。
-
math/big.Float.Uint64 超出 uint64 上界时不会报错,而是返回 math.MaxUint64,并用 Accuracy 表示结果落在输入值的哪一侧。本文拆开截断、负数、正小数和上溢边界,给出可复用的判断写法。
-
用 go list -json 读取包目录、编译文件和被构建约束排除的文件,再结合 GOOS、GOARCH、-tags、Imports、Deps 与 DepOnly 分析 Go 包的导入边界和跨平台差异。
-
Go 的 math.Copysign(f, sign) 会保留第一个参数的幅值,并采用第二个参数的符号。本文用最小示例说明参数顺序、负零以及 NaN 和 Inf 等边界。
-
Go debug/pe 的 COFFSymbol.FullName 会根据 Name 的编码形式,在 8 字节内嵌名称和 COFF 字符串表之间选择读取路径。本文说明长名称偏移、StringTable 输入、错误边界与调用方处理方式。
-
Go bufio.Scanner 的 Scan 返回 false 既可能是正常 EOF,也可能是输入或扫描错误。本文用 Scanner.Err 区分停止原因,并整理底层 Reader、超长 token、空输入和改用 bufio.Reader 的处理边界。
-
Go os/exec.Cmd.Start 返回错误时,不要直接比较错误字符串。本文按启动阶段与等待阶段拆开,使用 errors.Is 判断 exec.ErrNotFound 和权限错误,使用 errors.As 读取 *os.PathError,并说明成功启动后为什么仍必须调用 Wait。