-
Go Goldmark 默认按 CommonMark 解析 Markdown,表格语法需要显式接入 extension.Table。本文用一个最小 Go 示例说明 v1 的配置方式、Table 与 GFM 的选择、对齐输出和 v2 API 的迁移边界。
-
围绕 Go database/sql 事务重试边界,说明怎样识别明确死锁错误、回滚完整事务、使用有限退避,并通过统一加锁顺序、幂等设计和提交不确定性避免把重试变成重复写入。
-
用 Go time.ParseDuration 读取配置时长时,区分合法单位、空值默认、非法格式和业务范围校验,让超时与间隔配置在启动阶段可定位、可测试。
-
Go 升级后 ZIP 字节快照失败,不一定是归档损坏。本文区分整包哈希、内部校验与成员内容,按输入、元数据和压缩器逐层判断,并给出成员级测试及发布哈希的取舍。
-
Go 1.27 新增的 strings.CutLast 会围绕最后一个分隔符返回 before、after、found,而 strings.LastIndex 只返回字节位置。本文用重复分隔符、缺少分隔符、空分隔符和中文字符串说明两者的边界。
-
Go bytes.Buffer.Grow 只预留后续写入空间,不会增加 Len。本文区分 Len、Cap 与 Grow 的语义,并用拼接示例说明如何预分配容量、复用 Buffer 和处理参数边界。
-
解释 Go cookiejar 在没有 PublicSuffixList 时为何可能跨注册域共享 Cookie,并给出使用 publicsuffix.List 配置和回归测试的方法。
-
从 200、206 和 416 的响应症状出发,解释 Go net/http ServeContent 如何依赖 io.ReadSeeker 处理 Range 请求、获取内容长度和定位读取位置,并给出文件、自定义 Reader 与并发排障示例。
-
用 maps.EqualFunc 比较两个 map 时,键仍按 == 判断,值则交给自定义函数处理。本文从跨类型值、大小写规则、缺键与 nil map 讲清 API 边界,并给出生产代码选型清单。
-
Go archive/tar 的 Header.AccessTime 不是赋值后就一定会写入。本文说明 FormatPAX、FormatGNU 与未指定格式的差异,给出写入、读取和零值判断示例,并梳理访问时间的精度与兼容取舍。
-
Go x/text/secure/precis 的用户名 profile 会按 PRECIS 规则完成字符串准备、强制和比较,因此输入字符可能被映射、折叠或因不允许而返回错误。本文说明 UsernameCaseMapped 与 UsernameCasePreserved 的区别,以及展示值、存储值和比较键如何分离。
-
Go ksuid 可以生成带时间成分的 KSUID,并把它编码成 27 字符文本。本文用最小代码说明 NewRandom、String、Parse、Time、Timestamp 和 Payload 的使用边界。
-
Go context.Cause 看起来不稳定,通常不是 Cause 随机变化,而是父子 context 的第一次取消顺序、CancelCauseFunc 调用时机或超时 API 选择不明确。本文用最小代码拆开 Err、Cause、取消顺序和并发入口,给出可复查的排查方式。
-
Go 的 os.UserHomeDir 不是无条件返回一个目录:Unix 通常读取 HOME,Windows 读取 USERPROFILE,期望变量缺失时可能返回平台默认值,也可能返回非 nil error。本文用 CI 场景说明如何复现、处理和测试这个边界。
-
Go url.ParseQuery 看起来不生效,通常不是函数没有解析,而是传入了完整 URL、忽略了 error,或把多值参数当成单值读取。本文从输入格式、url.Values、多值参数和异常编码四个边界给出排查与封装写法。