-
zk.Connect不panic的关键是：传全地址列表、设5秒以上超时、连接后立即用State()检查是否为StateConnected，不能仅依赖err==nil。
-
生产环境应选用官方go-elasticsearch/v7客户端，需显式调用Do()、按字节而非条数切分bulk、解析聚合时先取键再断言类型。
-
swaginit需显式指定多目录路径并严格遵循注释格式：-g指定入口文件，-d列出internal/handler等子包；注释字段名、缩进、空格须精确匹配；泛型需手动@Schema声明；Nginx部署注意alias末尾斜杠。
-
Go函数参数永远传值，slice/map/chan因底层含指针字段而表现类似引用；array纯值类型，修改不影响原值；用指针参数需满足修改需求、大对象避免拷贝或接口要求指针接收者。
-
trace.Start()必须显式调用且配对trace.Stop()，否则trace.out为空或仅有头尾事件；常见原因包括未传*os.File、Stop未执行、程序过快退出、Start放置过晚。
-
Sync.Map不能用反射遍历，因其内部字段未导出且未实现迭代接口；必须通过Range()等公开API访问，注意nil检查、类型转换安全及性能陷阱。
-
Go语言中处理异常和错误的方式主要依赖于error返回和panic/recover机制。1.error返回用于常规错误处理，函数通过返回error值让调用者处理或忽略错误，适用于可预见的问题，如文件打开失败、网络请求超时等；2.panic用于触发运行时异常，程序沿着调用栈回溯，直到崩溃，适合处理不可预料的错误，如数组越界、空指针访问；3.recover只能在defer函数中使用，用来捕获panic，防止程序崩溃，常用于中间件统一拦截异常、测试代码模拟异常行为以及初始化阶段的关键错误处理；4.使用error
-
最稳妥方案是直接使用gobreaker库，它被go-zero和kratos验证成熟，支持滑动窗口统计、半开探测且无外部依赖；需正确配置MaxRequests（≥10）、Timeout（15s）、Interval（30s～2m），并在客户端调用处用cb.Execute包裹Do操作，配合context.WithTimeout和fallback降级，同时暴露指标便于观测。
-
RedisPubSub容易丢消息，因其非线程安全、默认缓冲区仅10条、无超时控制易卡死goroutine、重连不自动恢复订阅、无ACK机制且panic或慢处理会导致缓冲区溢出。
-
用status.Errorf包裹错误才能保留原始状态码；status.FromError只识别status.Status实例，其他包装会导致code降级为Unknown，自定义错误需实现GRPCStatus()方法返回真实status.Status。
-
Go中接口变量底层是两个字宽的iface结构体，仅当tab和data均为nil时才是真nil；若tab非nil（如(*T)(nil)赋值），接口不为nil但data为空指针。
-
reflect.TypeOf返回变量的实际类型，Name()仅对命名类型非空，Kind()才可靠判断基础类别；结构体私有字段不可见，需用Elem()、Tag等配合；反射性能低且易panic，应缓存Type并先判空。
-
要让函数修改值类型变量需使用指针传递，因Go语言参数传递本质为值传递，函数接收变量副本，修改不影响原始变量；通过传递变量地址，函数可解引用指针修改原始值，如changeValue函数无法改变外部num，而changePointer通过指针成功修改anotherNum；Go坚持值传递以提升代码清晰度和可预测性，减少隐式副作用，利于并发编程，但对大型结构体可能带来性能开销，此时指针传递可优化性能；典型使用场景包括需修改外部状态、处理大型结构体、方法修改接收者及处理可选参数；使用指针需防范空指针解引用、避免不必
-
Go标准库container包里的List、Heap、Ring不是“通用替代品”，而是为特定场景设计的轻量工具——用错地方反而比手写slice或map更慢、更难维护。什么时候该用container/list.List？list.List是双向链表，唯一不可被slice替代的场景是：需要在任意位置频繁InsertBefore/InsertAfter/MoveToBack，且不能接受O(n)查找开销（比如LRU缓存淘汰、事件调度器中的动态优先级调整）。常见错误现象：
-
本文详解通过GitURL重写机制，让goget支持基于SSH地址（如git@1.2.3.4:group/repo.git）的私有GitLab仓库，解决Go原生不识别SSH格式导入路径的问题。
