-
Go1.13通过%w支持错误包装，结合errors.Unwrap、Is和As实现多级错误溯源与类型判断，自定义错误需实现Unwrap方法以支持链式解析，避免重复包装和格式误用可提升可维护性。
-
Redis分布式锁易误判超时是因为SET成功后业务执行超时导致锁提前过期，需用唯一value校验+原子续期；ZK锁需监听前序节点防羊群效应，sessiontimeout须大于业务超时；解锁必须用Lua脚本而非DEL。
-
Go编译产物能直接运行于Alpine镜像，因其默认静态链接且不依赖libc；但启用cgo后会动态链接glibc，导致在Alpine（musl）或scratch中报错。
-
用reflect.TypeOf获取结构体类型后遍历NumField，取Field(i).Name得字段名；需传值或指针避免interface{}丢失类型，跳过私有字段（PkgPath!=""），仅补全string或TextUnmarshaler类型字段，支持json/yaml标签映射，嵌入字段按需递归但限深度，泛型具化后正常处理。
-
retract是模块根go.mod中声明式屏蔽旧版本的机制，仅影响下游执行gomodtidy时的依赖选择，不删除远程版本或改变go.sum；须配合新版本发布才能使@latest生效。
-
TinyGo编译失败主因是main.go位置错误或包名不符：必须置于go.mod同级根目录，文件名严格为main.go且首行为packagemain；tinygobuild需在该目录执行，不支持子路径；target名称须精确匹配（如raspberry-pi-pico非pico），否则烧录后板子无响应。
-
<p>Gomap扩容负载因子临界值为6.5，但实际判断基于count>(1<<B)*6.5且溢出桶过多两个动态条件，非简单元素数/桶数比值。</p>
-
Go语言推荐优先使用reflect.DeepEqual进行深度比较，它已支持常见类型及循环引用检测；仅当需忽略字段、浮点容差或自定义逻辑时，才基于reflect.Value手动实现，并注意处理不可比较类型、NaN、循环引用和未导出字段等问题。
-
正确构造测试请求需确保URL带协议和路径、body显式设为nil或io.Reader，并设置Content-Type；用httptest.NewRecorder捕获响应；完整链路测试应通过httptest.NewServer启动服务而非直调handler。
-
连不上ClickHouse通常是因secure和compress未正确关闭；TCP连接需显式设secure=false&compress=false；INSERT应使用PrepareBatch批量写入；Nullable字段须用sql.NullString或ch.String接收；分布式查询需加SETTINGS确保全局聚合。
-
Go拉取私有仓库失败主因是认证缺失或GOPROXY干扰：需配置git凭据助手（HTTPS）或SSH密钥（SSH），并设置GOPRIVATE跳过代理直连，三者缺一不可。
-
匿名结构体是无需预先定义的临时结构体，直接通过struct{}定义字段并创建实例，适用于局部数据组织、API响应解析等一次性场景，提升代码简洁性与可读性。
-
合理配置http.Transport是实现Go语言HTTP连接复用的关键，需全局复用Transport、调整MaxIdleConns和IdleConnTimeout等参数，并结合context超时控制与指标监控，确保高并发下连接高效复用。
-
模板方法模式在Golang中通过接口与结构体组合实现，利用嵌入结构体模拟继承，定义算法骨架并将可变步骤延迟到具体实现。示例中报告生成器的通用流程由BaseReport封装，FormatContent和Finalize作为钩子方法由不同报告类型（如HTMLReport、TextReport）重写，实现差异化行为。此外，通过函数字段（如FlexibleReport中的FormatFunc和FinalizeFunc）可动态替换钩子逻辑，提供更灵活的扩展方式。该模式适用于数据导出、构建流程等固定流程局部可变的场景
-
WaitGroup本身不导致内存泄漏，但会掩盖goroutine泄漏：Add/Done不匹配或goroutine内部阻塞，使wg.Wait()永不返回，导致goroutine及其栈内存持续累积，最终引发OOM。
