-
time.After不触发主因是NTP回拨导致系统时间倒退，使基于CLOCK_REALTIME的定时器等待已变为“过去”的绝对时间点重新到达，从而看似暂停。
-
net.Listen后程序立刻退出是因为未写Accept循环；必须用for循环持续调用listener.Accept()，否则只处理一个连接即终止，且需显式Close监听器。
-
swag生成API文档时接口未显示，主因是扫描路径未覆盖handler文件或package不合法；@Param报错因type只支持基础类型或@Model定义的struct；中文乱码源于swagger.json编码异常或注释含非法字符。
-
长连接网关中struct字段顺序关键，因Connection实例生命周期长、核心字段（如fd、state、readDeadline）被高频轮询或原子更新，若分散在多个64字节缓存行，将导致L1缓存miss率激增，实测吞吐下降7%；需按访问热度+大小双维度重排，使热字段紧凑落入前64字节，并隔离atomic字段防伪共享。
-
网关结构体字段顺序不合理会导致单实例多占30%～50%内存，因高频创建、批量分配及缓存行失效加剧GC压力与延迟；需按对齐优先级（8字节＞4字节＞1/2字节）重排字段，并用unsafe.Sizeof和Offsetof验证padding。
-
Go缓存核心是避免重复计算和I/O以降延迟、提吞吐，关键在缓存内容、时效、失效策略及线程安全；分内存、分布式、函数级三类方案，需防击穿、雪崩、穿透，并注意并发安全与资源控制。
-
因为未设置种子，rand默认使用固定种子0，导致每次运行结果相同；应改用rand.New(rand.NewSource(time.Now().UnixNano()))并避免全局状态污染。
-
reflect.Value无公开InterfaceData方法，它仅存在于runtime内部且不可调用；获取底层地址应使用UnsafeAddr()等安全方式，而非非法访问内部实现。
-
Goplugin仅支持Linux/macOS，Windows完全不支持；主程序与插件须同Go版本、构建参数及依赖版本；导出符号须为首字母大写的包级变量或函数，且类型具体；plugin.Open后必须检查Lookup错误。
-
Go测试中不手写if断言因易漏错误信息、格式不统一、定位难，且缺乏t.Helper()和并发支持；标准库刻意不提供断言以鼓励显式检查，社区多用testify/assert（新路径github.com/stretchr/testify/assert），它类型安全、自动t.Helper()、差异友好、错误链展开准确；简单场景用原生t.Errorf需带预期/实际值及上下文；自定义断言必调t.Helper()并注意延迟求值。
-
CGO返回的C指针不调用C.free会导致确定性内存泄漏，因GoGC不管理C分配内存，常见表现为OOM或RSS持续上涨；仅C侧分配（如C.CString、C.CBytes、C.malloc）需free，且须判空、防重释放、单goroutine释放。
-
Go位图索引应使用[]uint64而非[]byte或[]bool，因其内存紧凑、支持64位并行指令、减少边界检查；索引计算须用i>>6和i&63，分配按64向上取整，Get需防越界并明确返回false语义。
-
defer必须写在panic前面，因为defer是立即注册动作，将函数压入defer栈，而panic只执行已入栈的defer；若defer在panic后，则根本不会执行注册，自然不运行。
-
策略接口应只定义纯行为契约，共享依赖通过构造函数注入；避免空实现、全局变量并发写、硬编码路由及nil指针调用，推荐注册表+工厂函数+读写锁保障安全。
-
在Go中，fmt.Sprintf不支持直接对[4]byte类型使用a...展开语法，因为Go不允许隐式将固定长度数组（或切片）转换为[]interface{}，必须显式传入每个元素或手动转换。
