-
Go os.Root.Symlink 可以在受限根目录中创建链接入口,但 oldname 只是链接目标文本,不会自动替你校验目标是否仍在根目录内。本文用版本别名场景讲清 newname、oldname、相对目标以及 Symlink、Link、复制文件的选择边界。
-
Go compress/flate.NewReaderDict 只能处理原始 DEFLATE 数据,解压端还必须拿到与压缩端完全一致的预置字典。本文用一个可复用示例说明字典绑定、读取错误和与 zlib/gzip 容器的选择边界。
-
Go 1.26+ 使用 errors.AsType 提取包装错误中的具体类型,本文说明 %w、错误树、指针目标、nil 结果和从 errors.As 迁移时的边界。
-
Go 中读取 TLS 协商协议的关键是先完成握手,再从 tls.ConnectionState.NegotiatedProtocol 读取 ALPN 结果。本文说明握手状态、空协议名、TLS 版本、密码套件和日志记录之间的关系。
-
Go 里限制 HTTP 请求体不能只把 io.LimitReader 当成截断器。本文用原创示例说明如何读取上限内数据,并通过额外读取一个字节判断请求体是否真的超限。
-
Go 网络客户端需要区分 DNS 解析慢和 TCP 建连慢时,可以让 net.Resolver.LookupIPAddr 与 net.Dialer.DialContext 分别使用子上下文,并由父级 Context 约束总预算。本文给出解析、地址拼接、建连和错误处理的原创示例。
-
Go go/ast.IsGenerated 需要接收保留注释的 ast.File,用于识别生成代码约定;本文说明 ParseComments 前置条件、true/false 结果边界,以及源码扫描中的错误分类。
-
Go 的 jsontext.Value 是保存 JSON 原始文本的 []byte。本文从 ReadValue 的短期生命周期讲到 Clone 的独立副本,再说明 PreserveRawStrings、Indent、Compact 和结构化修改之间的边界,帮助你保留需要的 JSON 表示而不误用格式化 API。
-
Go 1.21 以后,工具链选择由 GOTOOLCHAIN、go.mod 或 go.work 中的 go 与 toolchain 共同决定。本文按固定版本、PATH 复用和自动下载三种工程约束比较配置方式。
-
Go vet 的 stdmethods 检查器会针对 WriteTo、ReadRune、MarshalJSON 等熟知方法名核对标准签名。本文用 WriteTo 示例说明如何运行 go vet、如何用接口断言确认修复,以及它不覆盖自定义接口的边界。
-
Go 中可以用 bytes.Buffer.Reset 清空当前长度并保留底层容量,适合在请求循环里复用临时缓冲。本文用可运行示例说明 Reset 的调用位置、Bytes 返回切片的生命周期、并发限制,以及大缓冲不应无限复用的边界。
-
用 os.Args 切分入口参数,为每个子命令创建独立 FlagSet。本文给出完整示例,说明同名选项、位置参数、全局前缀和 ErrHelp 的处理边界。
-
Go 遍历 tar 时,用 Reader.Next 获取当前 Header,再通过 Header.FileInfo().IsDir 判断目录;普通文件按需读取或复制到 io.Discard,不完整读取也可交给下一次 Next 自动跳过剩余内容。
-
用 Go math/bits.TrailingZeros64 扫描 64 位位图时,零值返回 64,不能直接当作有效位编号。本文给出最低置位提取、清位循环、索引映射和边界检查方法。
-
通过一个延迟标签任务说明synctest如何在bubble内推进虚拟时间,区分time.Sleep观察点与Wait同步,提供期限前后断言示例、资源边界和后台任务清理建议。