-
Go 1.26 新增的 errors.AsType 用泛型返回具体错误类型，省掉 errors.As 中声明目标指针和传入地址的样板写法。本文说明包装错误、自定义 As、errors.Join 与旧版本兼容边界。
-
SetConnMaxIdleTime 用来限制连接在池中连续空闲的最长时间，过期连接可能由清理器或复用前检查惰性关闭。它应与 MaxIdle、MaxOpen 和 MaxLifetime 配合，并通过 DB.Stats 观察淘汰计数。
-
errors.Unwrap 只调用 Unwrap() error，适合单链包装；errors.Join 返回值实现的是 Unwrap() []error，所以直接调用得到 nil。匹配原因应使用 errors.Is 或 errors.As，枚举时再显式处理多子错误接口。
-
sql.Named 会创建不带符号前缀的 NamedArg，database/sql 再将名称、序号和值交给数据库驱动。命名占位符是否可用、查询中的符号写法以及值转换规则都由具体驱动决定。
-
Go errors.Join 会生成实现 Unwrap() []error 的多分支错误树。errors.Is 会检查根错误并深度优先遍历每个子错误，因此可对多个原因逐个匹配；直接等号和 errors.Unwrap 不适用于该结构。
-
![Go sql.Null[T] 怎么扫描可空自定义类型](/uploads/20261006/1791300932-0da577e553-680dd7ac5c-cover-640.webp)
Go 1.22 引入的 sql.Null[T] 可以把 NULL 与自定义标量类型放在同一个扫描目标中。本文用 OrderState 和订单编码示例说明类型定义、Scan 调用、Valid 判断，以及 driver.Value 和旧版本兼容边界。
-
Go SectionReader 通过 base、当前偏移和 limit 建立固定读取窗口。本文解释 Read 的缓冲区裁剪、ReadAt 的相对偏移、EOF、Seek 与 Size 的边界语义。
-
sync.Pool 在池空时只有 New 非 nil 才会创建默认对象。本文用 bytes.Buffer 说明正确初始化、typed nil 陷阱、借用归还封装、状态重置和测试边界。
-
io.Copy 不一定走缓冲循环：它会优先调用 WriterTo 或 ReaderFrom。本文用调用顺序、CopyBuffer 边界和适配器示例说明自定义缓冲区为什么没有生效，以及如何正确控制这条路径。
-
Go 1.23 起，sync.Map.Clear 可直接删除并发映射中的全部条目，清空后仍能继续 Store 和 Load。本文通过可重置缓存示例说明基本用法、并发写入边界、旧版本兼容方案，以及需要严格换代时的原子指针切换设计。
-
Go 的 io.Reader 可以在一次 Read 中同时返回 n > 0 和 io.EOF。正确顺序是先处理 buf[:n]，再判断 err；否则会丢掉输入流最后一段有效数据。本文给出通用循环、错误优先级、0,nil 边界与标准库替代方案。
-
sync.OnceFunc 包装的函数如果首次执行 panic，被包装函数不会重试，但包装函数之后每次被调用都会使用同一个 panic 值再次 panic。本文给出最小示例、与 sync.Once.Do 的差异，以及线上恢复、失败缓存和重试设计建议。
-
Go 对字符串执行 for range 时，如果遇到非法 UTF-8，第二个迭代值会是 U+FFFD（utf8.RuneError），下一轮只前进一个字节。本文解释字节索引、连续非法序列、合法 U+FFFD 的歧义，以及 ValidString 和 DecodeRuneInString 的正确用法。
-
Go reflect.VisibleFields 会按 FieldByName 的可见性处理嵌入字段：浅层同名字段覆盖深层字段，同层同名字段互相抵消。本文用结构体示例说明冲突判断、StructField.Index 读取路径和 nil 嵌入指针边界。
-
strings.EqualFold 按 Unicode 简单大小写折叠直接判断两个 UTF-8 字符串，而 strings.ToLower 是把字符单向映射成小写。本文用希腊 Sigma、德语 ß 和组合字符说明两者差异、适用场景与工程边界。
