-
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。
-
JSON字段名需用jsontag重命名且字段必须首字母大写导出；omitempty对nil指针生效但对空字符串无效；大小写不一致时需预处理或自定义UnmarshalJSON；json.RawMessage可延迟解析避免冲突。
-
使用go.mod明确指定版本可锁定Golang依赖，如requireexample.com/some/modulev1.2.3；通过gogetexample/module@v1.2.3精确拉取并更新版本；必要时用replace指向本地路径调试；避免意外升级需遵循最小版本选择策略，定期用golist-mall和gomodgraph检查依赖；启用GOPROXY和GOSUMDB确保模块来源安全可靠，从而实现构建可重现与部署稳定性。
-
单机golang.org/x/time/rate.Limiter不能用于分布式场景，因其状态仅存于内存，多实例间不共享，导致实际QPS远超设定值；必须用Redis等外部存储配合Lua原子脚本实现分布式令牌桶。
-
Go并发计数器该用atomic.AddInt64还是sync.Mutex绝大多数场景下，优先用atomic.AddInt64——它快、轻量、无锁，且能正确保证计数器的原子性。只有当你需要「复合操作」（比如“读+判+写”）或计数器只是更大临界区的一部分时，才考虑sync.Mutex。哪些操作不能靠atomic完成，必须上Mutexatomic只保证单个操作的原子性，不提供「多步逻辑的原子封装」。一旦涉及条件判断或依赖当前值做决策，atomic就力不从心了。「如果计数器小
-
go.bug.st/serial.v1是最省心的串口库：纯Go实现、无cgo依赖、跨平台开箱即用；需分平台排查设备名与权限，Read/Write必须设超时和终止符，并发读写须加锁或分goroutine。
