-
Go constraint.PlusBuildLines 可以把 constraint.Expr 转成一组等价的 // +build 旧标签行。本文说明 Parse、转换错误、复杂表达式边界以及写回源文件时的新旧约束同步方法。
-
Go checksum mismatch 不能靠盲目删除 go.sum 或关闭 GOSUMDB 解决。本文按公共模块、缓存污染、重新打标签和私有模块四种边界,给出一套保留完整性校验、可复查且适合提交到团队仓库的修复方法。
-
Go SJSON 追加数组元素时,路径末尾使用 -1,例如 items.-1。本文拆开说明它与具体下标、越过数组末尾和数字对象键的区别,并给出可直接改写 JSON 的示例。
-
Go 的 vendor 模式和模块缓存不是两份等价副本:-mod=vendor 从项目根目录的 vendor 读取,-mod=mod 才会走模块缓存。本文按命令来源、modules.txt、工作区和工具链四个边界定位结果差异。
-
gctrace 的 clock、cpu 与堆目标各有统计口径。本文区分 STW 和并发标记、goal 与 RSS,说明先构建后采集的写法,以及日志开销、采样周期和结构化指标的边界。
-
系统证书环境变量改变后,应区分根证书来源与平台验证路径。本文说明 Go 1.27 的平台行为变化,以专用根池示例明确客户端信任边界,并提醒不要通过关闭 TLS 验证恢复连通。
-
Go 1.26 的 EncryptOAEPWithOptions 可以分别设置 OAEP 主哈希和 MGF1 哈希。本文按 Hash、MGFHash、label 与 RSA 模长四项参数,说明 Go 与 Java、OpenSSL 等对端如何建立可排查的 RSA-OAEP 互操作契约。
-
Go Doublestar 的 **.md 与 *.md 一样只匹配单个文件名段,递归应使用 **/*.md。结合内存文件树示例,说明双星号位置、零层目录、Match 与 Glob 路径基准及空结果的区别。
-
Go archive/zip 的 CRC 错误通常在条目完整读取到结尾时暴露,而不是在 File.Open 或 ReadCloser.Close 时返回。本文用 io.Copy、zip.ErrChecksum 和双层资源关闭说明如何准确识别损坏压缩条目。
-
Go x/text/number 中 MinFractionDigits 控制小数位下限,MaxFractionDigits 控制上限。本文按排障手册说明两者何时配套、何时只设一侧,以及 Scale 固定精度的选择。
-
Go slog 字段不该全部放在调用处,也不该全部由 Handler 猜测。事件事实留在调用处,稳定作用域字段用 Logger.With 绑定,Handler 只补 context 或运行环境可统一推导的横切字段。本文给出字段归属表、包装 Handler、降级规则和性能注意。
-
Go WithoutCancel 保留父级值查询,却不继承取消、deadline 与取消原因。本文解释 nil Done 的阻塞行为,用完整示例重新建立独立工作预算,并说明值引用、资源和权限的边界。
-
Go text/template 使用自定义函数时,应先通过 Funcs 注册 FuncMap,再调用 ParseFS 解析引用这些函数的模板。本文结合 embed.FS 说明调用顺序、函数签名、解析错误与执行错误的区别。
-
复用同一个结果结构体调用 Go mapstructure 解码时,未出现在新输入中的字段可能继续保留。本文解释默认合并行为,并给出 ZeroFields、重新创建结果对象和 Metadata 的选择方法。
-
Go 的 http.Transport.HTTP2 用于配置 HTTP/2 连接的高级参数,但它不负责选择协议。本文区分 Protocols 与 HTTP2Config,说明客户端可用字段、零值语义和服务端专属配置。