Go语言技术文章
-
io/fs.ValidPath 只接收 string，不能直接复用调用方的 []byte。动态路径应复用 []byte scratch，完成一次受控的 string 转换后再校验，并注意临时字符串的生命周期、容量和并发隔离。419 收藏 -
Go 的 io/fs.ValidPath 只接受不带根的斜杠路径。本文用 os.DirFS 建立受限根目录，先校验文件名再用 fs.ReadFile 读取，并说明 ..、符号链接、权限和运行身份的边界。467 收藏 -
用一个小型 docpeek 工具说明如何把本地目录包装成 fs.FS，组合 fs.ReadDir 与 fs.ReadFile，并处理 fs.ValidPath、相对路径和符号链接边界。114 收藏 -
os.DirFS 的根目录参数不能是空字符串，文件读取还要区分非法路径、文件不存在和权限错误。本文用 io/fs 的路径约束、errors.Is 和资源关闭写出清晰的异常分支，并提醒 DirFS 不等于符号链接隔离。148 收藏 -
os.DirFS 不接收字节缓冲区。本文用完整 Go 文件摘要示例说明如何在打开文件后复用工作区，并解释 CopyBuffer 快速路径、切片长度、串行所有权和目录访问边界。426 收藏 -
使用 Go os.DirFS 读取目录时，先用 fs.ValidPath 判断输入是否满足 io/fs 名称规则，再根据目录是否可信选择 os.DirFS 或 Go 1.24+ 的 os.OpenRoot。本文区分语法边界与符号链接安全边界，并给出选择表和可运行示例。286 收藏 -
os.DirFS 可以把固定目录暴露为 io/fs，但它不是 chroot 安全边界。本文从最小读取写法、fs.ValidPath 输入约束和符号链接风险讲起，并给出 Go 1.24+ 使用 os.OpenRoot 的安全替代方案。204 收藏 -
Go 测试辅助函数不必手动拼接父子测试名称，传入 *testing.T 后调用 t.Name() 即可获取当前测试或子测试的完整名称。本文说明表驱动测试、t.Helper 配合方式，以及名称作为诊断信息时的边界。177 收藏 -
Go 的 http.Request.UserAgent 会读取请求中的 User-Agent 字段。本文说明空值处理、日志记录和轻量归类，并划清它与认证、授权和设备识别的边界。345 收藏 -
从字段缺失、零字节文件、读取游标和写入失败区分Go multipart上传为空的原因，给出FormData最小提交和本机临时落盘诊断代码，比较解析大小与复制字节数。475 收藏 -
Go 升级后 gofmt 可能因为格式规则或实现调整产生少量空白差异。本文用变化文件数、diff 行数和工具链版本定位原因，再通过 go.mod、toolchain 与 CI 固定格式化环境。116 收藏 -
netip.ParseAddr 只解析 IP 地址，因此会拒绝带端口的完整端点。需要处理 host:port 时应改用 ParseAddrPort；IPv6 端点要写成 [地址]:端口，端口必须是数字。本文还说明 AddrPortFrom、区域标识、端口 0 和 MustParse 的适用边界。501 收藏 -
Go 的 math/big.Int 表示整数，调用 Quo 时会按整数除法截断，因此 5 除以 2 得到 2。需要保留小数时，应把输入放进 big.Rat，再用 Quo、RatString 或 FloatString 输出。本文同时说明 QuoRem、IsInt、除数为零和负数边界。384 收藏 -
Go 按字节截断可能拆开 UTF-8 编码。本文比较完整字节前缀与 rune 前缀，提供严格输入的原创函数，并说明替换字符、流式尾部和字素簇的判断边界。348 收藏 -
Go SMTP 返回 535 时，不要只看错误码猜原因。本文用 net/smtp 的 Auth、Mail、Rcpt 阶段区分账号认证失败与信封发件人被策略拒绝，并给出保留 SMTP Code 和 Msg 的排障写法。445 收藏