Go语言技术文章
-
Go 导入 internal 包被拒绝时，应先定位 internal 目录上方的允许路径，再用 go.mod 和 go list 对照 ImportPath、Module.Path 及嵌套 module，最后选择移动调用方或提取公开 API。152 收藏 -
Go 使用 embed.FS 读取子目录时，路径不是磁盘绝对路径，而是相对嵌入文件系统根的斜杠路径。本文说明 fs.ValidPath、path.Join 和 fs.Sub 如何配合，避免路径拼错和发布后找不到文件。153 收藏 -
Go 交叉编译后的二进制运行时报架构错误时，先核对 GOOS、GOARCH 与产物格式，再区分纯 Go、cgo、动态加载器和目标机器不匹配，避免只改一个编译参数。137 收藏 -
解释 Go CGO_ENABLED=0 后依赖包无法编译的原因，教你用 GOOS、GOARCH、CgoFiles 和 GoFiles 判断文件选择，并在启用 cgo、纯 Go实现与自有包双实现之间做出可验证的修复。418 收藏 -
Go 反射读取结构体 json 标签时，Get 无法区分未声明与显式空值。本文用 StructTag.Lookup 解释 value 和 ok 的三态判断，并说明格式异常应如何配合 go vet 排查。360 收藏 -
Go 交叉编译开启 cgo 后找不到目标编译器，通常是只设置了 CGO_ENABLED 而没有准备匹配 GOOS/GOARCH 的 CC、目标头文件、运行库和链接器。本文按变量、工具链和报错层次给出排查方法。444 收藏 -
Go 读取结构体自定义标签时，先通过 reflect.TypeOf 和 Field 拿到 StructField，再用 Tag.Lookup 区分标签缺失与显式空值；Tag.Get 适合只关心字符串的兼容场景，但非约定格式的返回值不应被依赖。291 收藏 -
Go 的 build tag 不是只作用于测试文件。本文拆开构建约束、_test.go 后缀和 go test 文件选择规则，给出用 go list 与 go test 定位测试覆盖问题的方法。375 收藏 -
Go 1.23 的 range-over-function 会把循环里的 break 转成迭代器可识别的停止信号。本文用 iter.Seq、Seq2 和 iter.Pull 说明 yield 返回 false、defer 清理与 stop() 的配合，解决惰性遍历提前结束时资源没有释放的问题。380 收藏 -
Go 按平台拆分文件时，文件名后缀本身就是构建约束；本文说明 GOOS、GOARCH、//go:build 的叠加关系，并用 go list 查看实际入选文件，排查同名实现冲突和跨平台测试遗漏。263 收藏 -
iter.Seq2 的 K、V 是按值传给 yield 的，不能靠取 range 变量地址消除复制。本文对比指针返回、ID 句柄和保留值返回，给出生命周期、并发与提前停止的实用边界。441 收藏 -
Go build tags 复杂组合容易把 AND、OR、文件名后缀和 cgo 条件混在一起。本文用布尔表达式、go list 文件集合和跨环境测试矩阵，说明如何验证每条 build tags 路径。191 收藏 -
用 Go 1.23 的 iter.Seq 把 cursor 分页查询包装成惰性遍历，说明 yield 返回值、提前停止、重复游标和错误边界；需要保留页码时再用 iter.Seq2 传递附加信息。203 收藏 -
发布 Go 模块时，不能只检查 vendor 目录是否存在。通过重新生成 vendor、对照 vendor/modules.txt 和强制 -mod=vendor 构建，可以及时发现依赖版本漂移。312 收藏 -
maps.Keys 返回的键迭代顺序并不保证一致。本文用 slices.Sorted 和兼容写法，把 map 键转换为可复现的排序切片，并解释稳定结果与稳定排序算法的区别。158 收藏