Go语言技术文章
-
介绍 Go os.Root.Name 获取目录名称的用法，给出打开、读取和关闭示例，说明名称在诊断日志中的用途，以及它与绝对路径、实时位置和资源状态的区别。110 收藏 -
Go bytes.Buffer.Grow 只预留后续写入容量，不会增加有效数据长度。本文区分 Grow、Len、Cap 和 Bytes，说明如何正确写入、读取、复用缓冲区并处理边界。110 收藏 -
Go database/sql 的 rows.Next 返回 false 只表示遍历结束，不能直接当作成功；本文用一个可复用示例说明如何通过 rows.Err 捕获迭代错误，并区分 Query、Scan 与 Close 的诊断边界。109 收藏 -
os.File.Sync 返回成功仍读不到预期内容时，按写入完整性、读回位置、目录项和底层存储四层排查，避免把文件同步误认为事务提交。109 收藏 -
Go html/template 输出和预期不同，通常不是数据丢失，而是模板根据 HTML、属性或 URL 上下文自动转义。本文用最小示例区分纯文本、可信 HTML 和不安全 URL，给出不绕过安全保护的排查与修复方法。108 收藏 -
filepath.Localize 先检查 io/fs.ValidPath，再检查目标操作系统能否表示路径。本文拆解空元素、点路径、反斜杠、冒号、NUL 与 Windows 保留名等错误边界，并给出可执行的排查顺序。108 收藏 -
本文围绕运行时正则配置的常见故障，说明怎样使用 regexp.Compile 返回可诊断错误，在配置加载阶段保留规则名称和原始语法错误，并区分编译失败与文本匹配不到。107 收藏 -
go/scanner 的自定义错误处理通过 Init 的 ErrorHandler 参数注册。保存回调中的 token.Position 与消息，可保留文件名、行号、字节列及偏移；同时区分 text/scanner 的 Error 字段与 Scan 的 token 位置。107 收藏 -
Go unique.Make 可将重复字符串映射为可比较句柄，并通过 Value 恢复文本。本文用标签计数示例说明空输入、业务索引、并发与生命周期边界。107 收藏 -
Go os.Root.ReadFile 适合在已打开的根目录边界内读取配置、模板和小型元数据。本文说明相对路径语义、ErrNotExist 与越界错误的区分、Root 生命周期，以及何时改用 Root.Open 进行流式读取。106 收藏 -
Go template.Template 得到空结果时，先分清空根模板、执行了错误的命名模板、空管道和缺失 map 键。本文用 DefinedTemplates、Lookup、ExecuteTemplate 与 missingkey 给出可复现的排查路径。106 收藏 -
Go slog.Logger.Enabled 可以在日志级别判断阶段提前返回，避免为不会输出的日志构造昂贵参数。本文用最小示例说明 HandlerOptions.Level、Enabled、LogAttrs 与 LogValuer 的配合边界。105 收藏 -
解释 synctest 的任务归属、channel 与 timer 关联边界，给出自包含通知测试，说明 Wait 的观察范围及启动、取消、退出应如何放进同一气泡。105 收藏 -
Go mime/multipart.Reader 中，Part.Read 返回 io.EOF 表示当前部件结束，NextPart 返回 io.EOF 才表示整个 multipart 消息结束。本文用手动读取、io.ReadAll 和异常输入三个示例说明结束判断、n>0 与 EOF 同时返回及部件切换边界。105 收藏 -
context.WithCancelCause 让调用方既能判断上下文已经取消，又能读取导致取消的具体错误。本文用一个可复用的 worker 示例说明 cancel、Cause、父子上下文和 nil cause 的边界。103 收藏