-
io.NewOffsetWriter 把 WriterAt 的基础偏移包装成可定位的写入视图。本文从固定区间写错位置的故障现场出发,讲清 Write、WriteAt、Seek 的位置语义、错误边界和使用取舍。
-
Go bufio.Reader.Peek 可以预览接下来的字节而不移动读取位置。本文用协议前缀场景说明 Peek、Read、Buffered 和 Discard 的区别,并处理短读、ErrBufferFull 以及返回切片的有效期边界。
-
说明 Go bufio.Reader.ReadRune 遇到非法 UTF-8 时 RuneError、size=1 与 err=nil 的关系,并给出区分非法字节、合法替换字符和 EOF 的严格读取方案。
-
Go regexp/syntax.Regexp.MaxCap 会递归遍历正则语法树,返回捕获组编号中的最大值。本文说明 Parse 后怎样读取这个结果、为什么没有捕获组时返回 0,以及如何把它接入配置登记、失败记录和字段名表处理。
-
Go strings.Reader.Len 返回当前位置之后的未读字节数。本文区分 Len、Size 和字符数量,说明 Read、ReadRune、ReadAt 对读取位置的影响,并给出稳定的读取循环写法。
-
用 Go log/slog 编写自定义 Handler 时,Record.Attrs 可以按记录顺序遍历当前日志属性。本文给出 Handle 实现、Group 处理和边界清单。
-
Go 的 regexp/syntax.Regexp.Simplify 可以把正则语法树化为语义等价但更紧凑的表示,适合在可配置正则进入执行层前保留一份可审计的规范形态。本文用原创示例说明解析、化简、再编译的边界,并提醒它不能替代输入校验、匹配测试或性能基准。
-
Go 1.22+ 的 ServeMux 可以用命名通配符承接路径参数,处理器通过 Request.PathValue 读取。本文从一次参数读空的故障切入,说明单段与多段通配符、空字符串边界、参数名拼写和 SetPathValue 覆盖值的处理方式。
-
Go 的 encoding/ascii85.Decode 不负责识别 Adobe 的 <~ 与 ~> 外层符号。本文用一个严格的单块解析函数先校验并剥离包络,再处理 flush、返回值和 CorruptInputError,最后比较它与直接解码、流式 NewDecoder 的适用边界。
-
Go http.Cookie 设置 Partitioned:true 时需配合 Secure:true,再通过 SetCookie 输出响应头。本文用非敏感偏好小服务说明字段配置、Valid 与序列化的区别,以及 HTTPS 和客户端分区存储的接入条件。
-
Go 的 jsontext.Value 是保存 JSON 原始文本的 []byte。本文从 ReadValue 的短期生命周期讲到 Clone 的独立副本,再说明 PreserveRawStrings、Indent、Compact 和结构化修改之间的边界,帮助你保留需要的 JSON 表示而不误用格式化 API。
-
Go 1.27 的 encoding/json/v2 提供 MarshalWrite,可以把值直接编码到 io.Writer;需要 token 级控制时再使用 jsontext.Encoder。本文围绕大对象输出、Writer 错误、内存边界和 API 选择给出原创示例。
-
Go slog Handler 可以在 Handle 阶段读取请求上下文,把 request_id、trace_id 等关联字段补到每条日志中。本文从字段缺失的现象出发,给出保留 Enabled、WithAttrs、WithGroup 语义的包装写法,并说明并发、空值与敏感信息边界。
-
runtime/debug.SetPanicOnFault 用来调整 Go 运行时遇到非 nil 地址故障时的处理方式。本文从默认崩溃与主动转为 panic 的行为基线入手,说明返回值、当前 goroutine 范围、runtime.Error 地址信息和恢复边界,避免把它误当成通用的内存安全方案。
-
Go slog 不会自动读取 pprof 标签。本文用同一个 task_id 把结构化日志、context.Context 和 runtime/pprof.Do 串起来,并说明后台任务的标签生命周期、取消处理和排查顺序。