-
Go模块v2+必须显式在module路径中包含/v2，如modulegithub.com/user/pkg/v2；否则下游引用github.com/user/pkg/v2会失败，因v2是独立模块而非v1升级。
-
maxminddb是当前最靠谱的GoGeoIP库，因其纯Go实现、无CGO依赖、跨平台、更新及时且为MMDB格式事实标准；需用github.com/oschwald/maxminddb-golang，正确加载.mmdb文件并复用Reader。
-
elastic.NewClient()默认健康检查会导致初始化panic，需设SetHealthcheck(false)并手动Ping；TLS必配https和自定义HttpClient；索引需显式创建，struct字段要导出并加jsontag；批量用Bulk而非循环Index；中文搜索需创建索引时固定mapping。
-
time.Parse总是返回0001-01-01是因格式不严格匹配：layout必须与输入字符串在年月日、时分秒、时区、空格及标点上完全一致，否则返回零值且err为nil。
-
Go语言基准测试使用testing.B和b.N循环执行函数，通过gotest-bench=.测量性能，添加b.ReportAllocs()可查看内存分配情况，避免编译器优化影响结果。
-
Go程序中应自行实现树形目录展示而非调用tree命令，因后者跨平台不稳、格式难定制；推荐用filepath.WalkDir或os.ReadDir递归遍历，配合层级符号（├──/└──）和缩进控制，注意权限错误处理、路径标准化、Unicode宽度及终端兼容性。
-
连接未复用是因为Keep-Alive需客户端和服务端协同生效，常见原因包括：Transport未配置MaxIdleConnsPerHost、未调用resp.Body.Close()、IdleConnTimeout过短，或Client未复用导致连接池失效。
-
本文详解如何将Vala生成的GTK+C接口（.o文件）正确集成到Go程序中，解决因重复定义导致的链接错误，并推荐使用静态库（.a）方式实现安全、可复用的CGO链接。
-
本文详解Go语言中使用sql.QueryRow时常见的类型误用错误，重点说明为何直接将*sql.Row赋值给error变量会导致编译失败，并演示如何通过Scan()方法正确获取并判断数据库查询结果与错误（如sql.ErrNoRows）。
-
用rate.Limiter做单机限流最稳妥，它基于令牌桶算法、线程安全、可扛突发；需复用实例、用Wait(ctx)避免阻塞；按用户/IP/路径限流时须用sync.Map缓存并定期清理过期key；集群场景必须用Redis+Lua原子实现。
-
excelize读写Excel最稳但易踩坑：Save()需改WriteTo或SaveAs确保落盘；SetCellValue数字需设NumFmt样式防误解析；读取优先用GetCellFloat/Int；并发写须避免共用File实例。
-
注册TerraformProvider插件需调用plugin.Serve()启动gRPC服务并传入terraform.ProviderServer实例；Provider()必须返回非nil的schema.Provider实现；ConfigureFunc应返回diag.Diagnostics而非panic；ResourceCRUD中ResourceData非线程安全，须避免goroutine并发修改；import需实现Importer.State方法返回[][]*schema.ResourceData；敏感
-
Jackson反序列化List需指定泛型类型，推荐使用TypeReference匿名类方式：newTypeReference<List<User>>(){}；或JavaTypeconstructCollectionType；Spring中可用ResolvableType；也可ParameterizedType手工提取或TypeUtils封装。
-
最稳妥方式是用sync.WaitGroup+sync.Mutex汇总错误：预分配线程安全错误切片，Mutex保护写入，WaitGroup确保等待完成；配合errgroup.WithContext实现取消与首错退出，任务中检查ctx.Err()并将错误写入共享切片后返回nil。
-
长轮询不能用http.TimeoutHandler因其强制关闭连接导致退化为短轮询；应禁用读写超时，用context、time.After和select实现客户端断开、服务端推送、超时退出三重控制，并通过defer清理资源防泄漏。
