-
big.Int运算必须调用方法而非操作符，初始化须用SetString，负数模运算结果可能为负，JSON/数据库需手动处理，避免Int64()中转和未清零的sync.Pool复用。
-
应优先选用bleve或GoFound而非自研倒排索引：bleve适合嵌入式场景但需预建目录、显式配置字段索引与分词器、规范ID生成；GoFound更适单机亿级日志/文档搜索，开箱支持中文、自动持久化，但缺乏字段级控制。
-
使用channel聚合多协程结果，定义Result结构体携带数据和错误，通过带缓冲channel收集各协程输出，主协程汇总确保并发安全。
-
Go游戏服务端无法实现真正的代码热更新，但可通过不可变配置结构体+原子指针替换、分片异步加载、显式状态快照与回放，安全低感知地完成配置热更与状态平滑迁移。
-
Go标准库math/rand不支持直接加权随机，因其rand.Float64()仅生成[0,1)均匀浮点数，需手动将权重映射为区间并用随机数落点判断；线性遍历累加在大数据量时为O(n)瓶颈，推荐前缀和+sort.Search实现O(logn)高效查找。
-
errgroup.Group比sync.WaitGroup更适合错误传播，因其内置首次错误即返回机制，支持自动终止未启动任务，并需配合context实现可取消并发；零值不可用，须用new或WithContext初始化；子任务须显式返回error。
-
ebiten.RunGame会卡住或退出是因为它不返回，必须是main()最后一行；图片显示异常需注意设备缩放和错误检查；按键检测要用边沿触发；资源须用embed.FS嵌入；Update必须显式返回error。
-
必须分两层处理：生产端用channel.Confirm，消费端关autoAck并显式调用Ack/Nack；autoAck=true仅表示网络送达，不保障业务成功，会导致消息未处理即丢失。
-
select配合time.After是Go中最轻量常用超时控制方式，但需避免直接套模板导致定时器未复用或goroutine泄漏；正确做法是复用timer或用context.WithTimeout。
-
Go命令找不到说明未安装，Linux用aptinstallgolang最简捷，macOS/Windows需配GOROOT、GOPATH及PATH，务必设GOPROXY=https://goproxy.cn并验证goversion。
-
gRPC双向流函数名需严格匹配生成代码中的签名，服务端handler首参必须为*pb.DataStream_Service_SyncServer，客户端使用pb.DataStream_Service_SyncClient，收发需并发处理。
-
golang乱码本质是编码链路未对齐，核心解决法是显式控制编码转换而非依赖隐式猜测：源文件须存为无BOM的UTF-8；终端需设为UTF-8（如chcp65001）或程序输出适配终端编码；读写文件、HTTP响应、数据库连接等各环节均需显式声明并转换字符集，确保字节流与解码预期严格一致。
-
Go程序必须以packagemain开头且含funcmain()，输出用fmt.Println并import"fmt"，gorun快速验证，gobuild生成可执行文件，无需早期配置GOPATH或gomod。
-
索引优化是提升Golang应用查询性能的关键，需合理选择高频、高区分度字段创建索引，遵循最左匹配原则，避免全表扫描和索引失效，利用覆盖索引减少回表，结合EXPLAIN分析执行计划，使用预编译语句，并定期监控与清理无用索引，确保数据库高效运行。
-
三色标记法标的是对象可达性确定程度：白色=尚未证明可达、灰色=待扫描（工作队列）、黑色=已扫描但非绝对安全；混合写屏障需栈标黑+堆插入+删除屏障协同防漏标；GC仅有两次极短STW，分别用于初始化标记和确保栈标记完成。
