-
用Docker跑单节点Kafka应直接使用KRaft模式（KAFKA_PROCESS_ROLES=broker,controller），禁用ZooKeeper；sarama生产者需显式设RequiredAcks=WaitForAll、Return.Successes=true、Version精确匹配，并避免NSQ替代Kafka本地调试。
-
blackfriday已归档弃用，应改用goldmark；其最小渲染仅需三行代码，但需注意扩展注册（如Table、CodeFence、GFM）、HTML转义控制及unsafe选项的配套禁用。
-
Go常量必须初始化、不可修改、类型可推导或显式指定；声明需用常量表达式，支持分组与iota枚举，编译期确定且利于优化。
-
Facade、Observer、CircuitBreaker、ServiceDiscovery是Go微服务中高频落地的四大模式：Facade用于网关层轻量编排多服务调用；Observer借助消息队列异步解耦服务通知；CircuitBreaker需合理配置阈值、超时与降级逻辑；ServiceDiscovery结合单例gRPC连接实现动态负载均衡与健康检查。
-
sync.Once.Do仅保证同一实例上函数最多执行一次，不处理panic、不重试、不保证成功；其通过uint32done字段和atomic.CompareAndSwapUint32实现无锁判断，首次调用执行并原子置1，后续直接返回。
-
直接用SETkeyvalueEXsecondsNX做心跳不靠谱，因其无法保证更新基于最新状态，且缺乏原子性条件更新能力，易导致并发覆盖和非法状态跃迁。
-
sync.RWMutex适用于读多写少场景，如配置缓存、路由表；写频繁时反比Mutex慢；需配对使用RLock/RUnlock，避免死锁与panic，嵌入结构体时必须用指针接收器。
-
LRU缓存必须支持O(1)查找与O(1)节点移动，而container/list的*list.Element无法直接关联key，导致Get需遍历链表、退化为O(n)，违背设计初衷；高效实现须用哈希表映射key到自定义双向链表节点，并原子性同步更新二者。
-
能，但仅对同一goroutine内的panic有效；跨goroutinepanic无法recover，会导致程序崩溃。HTTP中间件需在handlergoroutine内deferrecover并处理返回值，记录堆栈、返回500响应。
-
<p>在Golang中实现网络客户端超时控制需设置http.Client的Timeout字段，如client:=&http.Client{Timeout:10*time.Second}；可通过自定义Transport对DialContext、ResponseHeaderTimeout等进行细粒度控制；还可使用context.WithTimeout动态取消请求；超时错误可通过net.Error类型断言识别并处理。</p>
-
使用errgroup.Group可实现并发任务的错误聚合，遇到首个错误即返回；若需收集所有错误，可用带缓冲channel或sync.WaitGroup配合互斥锁保护错误切片，推荐优先使用errgroup或channel以避免竞态条件。
-
Golang日志收集核心是轻量、可靠、可扩展，关键在设计采集→传输→存储→查询链路：HTTP中间件用结构化JSON日志，通过context注入trace_id，异步channel缓冲+批量发送，失败降级落盘。
-
优先用oss.PutObjectFromFile上传本地文件，小数据或字节切片用oss.PutObject并显式设置ContentLength和ContentType；Endpoint必须为带协议的Region地址，凭据需用RAM子账号，私有object需设ACL公开。
-
GoHTTP服务端需禁用ParseMultipartForm，手动读取request.Body流式写入分片，并通过URL参数传元信息、SHA256校验、uploadId状态持久化及TTL清理实现可靠断点续传。
-
Go不能反射调用私有方法，这是语言设计的硬性限制：reflect.Value.Call对非导出方法直接panic，reflect.MethodByName返回零值且IsValid()为false，因Go反射仅暴露导出成员，私有方法不进入类型方法集。
