-
Go generate 可以通过 package 路径、同目录 Go 文件列表以及 -run、-skip 精确缩小生成范围。本文结合注释触发、执行顺序和失败边界，说明如何只对指定包运行代码生成指令。
-
Go image.Decode 得到空结果时，优先检查错误、格式注册和 Reader 读取位置。本文用最小示例说明空输入、未注册解码器、预读后未回退和 DecodeConfig 尺寸边界的处理方式。
-
Go encoding/json 解码到 map[string]any 时，JSON 数字默认映射为 float64。本文用最小复现解释原因，并给出结构体与 Decoder.UseNumber 两种保留数字语义的处理方式。
-
filepath.Rel 只计算 basePath 与 targPath 的词法相对关系，不会自动阻止目标路径越出根目录。本文用 Go 示例说明如何处理返回错误、判断 .. 或 ../ 越界结果，并解释 Clean 与符号链接带来的边界。
-
reflect.TypeFor 读取的是泛型参数的静态类型，不会因为没有动态值而返回空类型；真正需要单独处理 nil 接口的是 reflect.TypeOf。本文用一个类型描述小工具串起两种 API，并处理 Kind、Elem 和不支持展开的异常分支。
-
使用 Go archive/tar.Writer.WriteHeader 写入目录 Header 时，关键是设置 tar.TypeDir、规范 Name，并把目录视为无数据体条目；随后再通过新的 Header 写入目录中的普通文件。
-
用 Go slices.Compact 编写按行去重工具，区分相邻去重和排序后全局去重，提供完整代码、输入容量限制、错误处理与数量对比，并说明性能测量和切片共享的边界。
-
让 json.Encoder 直接写最终 Writer，减少应用层字节和字符串往返；需要暂存时复用 Buffer，同时处理容量保留、Bytes 借用、并发和错误边界，不承诺零分配。
-
Go 的 net/mail.AddressParser.ParseList 可以把逗号分隔的邮箱地址解析为 []*mail.Address。本文说明普通地址、显示名、带引号逗号和解析错误的处理边界，并比较它与 Header.AddressList 的使用场景。
-
Go net.Dialer 只负责建立连接，成功返回后的 net.Conn 仍由调用方关闭。本文用生命周期日志、goroutine profile、文件描述符趋势和 httptrace 区分连接未关闭、读写卡住与 HTTP 连接池复用，并给出可落地的修复边界。
-
x509.Certificate.SerialNumber 的类型是 *big.Int，直接转 int64 可能溢出，也不适合做统一日志键。本文给出稳定十六进制格式、issuer 与 serial 的组合方式，以及 nil、负值和原始 DER 编码的边界处理。
-
context.Cause 返回的 error 不能只靠字符串判断。本文从取消信号的生命周期出发，说明如何用 ctx.Err() 判断标准状态，用 errors.Is 和 errors.As 判断自定义原因，并区分主动取消、超时和父级传播。
-
Go database/sql.DB.Stats 返回的是连接池累计与瞬时状态。本文说明如何读取 InUse、Idle、WaitCount 和 WaitDuration，用连续采样计算等待窗口，并区分连接池触顶与数据库服务器慢查询。
-
用 Go 1.24 的 os.OpenRoot 固定文件访问根目录，再结合 bufio.Reader.Peek 查看文件头而不推进读取位置；文章同时说明短文件、缓冲区大小、越界路径和符号链接边界的处理方式。
-
用 os.DirFS 和 io/fs.WalkDir 遍历一个目录，保留 Go 文件系统约定的相对路径；本文从根目录、回调错误、普通文件筛选和 filepath 转换几个体验点说明如何写成可复用的小函数。
