-
Go 的 sort.Slice 不保证相等元素保持原始顺序,sort.SliceStable 会保留这种相对顺序。本文从业务语义、多关键字排序和基准测试三个角度说明何时值得使用稳定排序,以及它的原地修改和比较函数边界。
-
用 context.WithTimeout 配合 database/sql 的 QueryContext 家族取消超时查询,区分请求取消、查询超时和数据库错误,并正确关闭 Rows、释放连接资源。
-
看到 go.mod 中的 // indirect 不要直接批量删除。本文结合 go mod graph、go mod why -m 与 go mod tidy 差异,说明如何区分传递依赖、测试依赖和版本选择影响,判断间接依赖是否仍需保留。
-
围绕 Go io.SectionReader.ReadAt 解释 n 与 err 的组合语义,说明局部偏移、区间末尾短读和 io.EOF 的正确处理方式,并给出不会丢弃部分数据的读取函数。
-
本文围绕 Go strings.Cut 解析一次分隔符的场景,说明 before、after、found 三个返回值如何区分缺失分隔符、空值和带分隔符的值,并给出可复用的键值解析实现。
-
Go log/slog 中,slog.Group 适合把一条记录的相关 Attr 收进命名组,Logger.WithGroup 适合为子系统建立持续字段路径。本文结合 TextHandler、JSONHandler、LogAttrs 和空组边界,说明如何组织 request、job 与模块日志字段。
-
Go database/sql 的 Tx.Commit 没有 context 参数,事务上下文来自 BeginTx。本文解释 context 取消后的自动回滚、Commit 错误、defer Rollback 模板和驱动交互边界。
-
Go types.Tuple 保存函数参数或返回值的有序变量列表。本文说明怎样通过 Signature.Results、Tuple.Len、Tuple.At 逐项读取多返回值,再用 Var.Name、Var.Type 和 Var.Pos 配合 token.FileSet 输出名称、类型与声明位置,并处理匿名返回值和空结果。
-
token.Pos.IsValid 只回答源码位置是否不是 NoPos,不负责判断位置属于哪个文件。本文从零值边界出发,说明 AST 节点位置的安全判断、FileSet 归属与 Position 行号有效性的区别,并给出工具代码中的防误用写法。
-
Go 的 goroutineleak profile 可以通过 net/http/pprof 暴露在 /debug/pprof/goroutineleak,再用 go tool pprof 查看泄漏栈。本文说明接入入口、抓取方式、采样对照和结果解读边界。
-
说明 gofmt 只读差异检查、生成目录排除与生成标记的区别,提供处理文件路径、工具错误及空检查集合的 Bash CI 示例。
-
用 Go archive/tar 解包外部归档时,先用 filepath.IsLocal 拒绝绝对路径和 .. 越界路径,再限制条目类型并安全写入目标目录。
-
Go 读取系统根证书应使用 x509.SystemCertPool,并保留加载错误。本文说明如何追加企业 CA、配置 tls.Config.RootCAs,以及 SSL_CERT_FILE、SSL_CERT_DIR、平台验证器和容器 CA 证书包的排查边界。
-
Go 的 time.Ticker 适合持续唤醒周期任务,但不会保证每个时间点都执行一次。本文用可停止的 select 循环讲清 ticker.C、Stop、Reset、慢处理丢 tick 和任务不重叠的工程边界。
-
围绕 go.work 的 use 目录集合,说明如何用 go work edit 的 -use、-dropuse、-json 和 -fmt 做低风险编辑,并区分它与 go work use、go work sync 的职责。