-
Go中全局变量是状态管理最危险的捷径，因其导致并发不安全、测试难隔离、多租户混乱且违反依赖显式化；应将状态绑定到具体实例，用组合+接口驱动流转，仅极少数场景（如连接池）可用sync.Map或atomic.Value安全实现。
-
不能用net/http.Handler直接做多协议转换，因其强制消费请求体和修改头部，破坏gRPC/WebSocket/MQTT等依赖原始字节流或连接生命周期的协议；必须分层处理：HTTP层仅识别分流，绝不读Body，再由专用codec接管连接。
-
Go中唯一推荐的单例实现是sync.Once+包级指针变量，因其线程安全、延迟初始化、支持错误返回；禁用if-nil判断（易竞态）、init()（无法按需/返错/测试）及局部声明once（失效）。
-
使用dchest/captcha或mojocn/base64Captcha均可，但需注意：前者VerifyString验证即删ID，后者store.Verify需显式设true才删除；两者均无自动过期，须配SetExpiration或换RedisStore；reCAPTCHAv3必须校验响应中的Hostname、Action与Score，且secretkey严禁硬编码。
-
因日志场景吞吐优先，sarama支持异步批量生产、TCP连接复用、自动重试及精细参数控制，而kafka-go默认同步写、批量需手动实现，压测易成瓶颈；但需谨慎配置sarama的MaxOpenRequests等参数以防阻塞或超限。
-
滑动窗口计数器不能用无锁map+time.Now()，因并发读写panic、遍历删key性能差且时间戳取整导致统计偏差；应使用预分配原子数组分片；漏桶禁用time.Ticker，需按需补token并防时钟回拨；rate.Limiter是令牌桶非漏桶；分布式必须用RedisZSET+Lua+服务端时间。
-
用Go构建轻量笔记分类与搜索功能，核心是结构体嵌套实现多级标签（如"tech.go.web"）、内存索引加速查询、标准化文本匹配支持AND搜索及权重排序，并通过HTTP接口暴露分类检索与全文搜索能力。
-
飞书机器人Webhook地址必须以https://开头且无空格或换行，需用strings.TrimSpace()清洗并校验前缀；日志告警应通过异步Hook实现，避免阻塞主流程。
-
Goldenfile测试是通过字节比对验证确定性文本输出是否被意外修改的实践，需用filepath.Join动态生成路径、统一LF换行、bytes.Equal精确比对，并通过-update标志安全更新，配合cmp.Diff定位差异。
-
sync.Map适合读多写少、无过期淘汰需求的轻量场景，如配置热更新；需TTL、LRU或容量控制时应选gcache、bigcache、freecache或ristretto等第三方库。
-
Go编译Windowsexe需显式设GOOS=windows和GOARCH，否则生成非PE文件；闪退多因CGO依赖VC++运行库，应设CGO_ENABLED=0；-o仅控制输出名，图标、版本等需go-winres等工具处理。
-
优先用channel传递数据或协调执行顺序，因其天然支持所有权转移与阻塞同步；仅保护少量共享状态时，Mutex更轻量高效。
-
用container/heap实现可修改优先级队列需封装结构体并完整实现heap.Interface，包括Less、Swap、Len、Push、Pop；关键是在任务结构中维护index字段，并在Swap/Fix时同步更新，以支持O(logn)优先级调整。
-
值接收者可以实现接口并支持多态，但不能修改接收者状态；指针接收者可修改对象状态且仅能由指针实现接口。1.值接收者方法可被值或指针调用，适合不修改状态的场景；2.指针接收者方法只能由指针实现接口，适用于需修改状态的情况；3.值类型赋值给接口时自动复制，指针接收者方法修改的是原对象；4.多态成立与否取决于方法集，而方法集与接收者类型相关。
-
使用go:embed将静态资源打包进Go程序，能实现单文件部署、避免路径问题、简化依赖管理。1.定义变量接收资源内容，类型通常为embed.FS；2.使用//go:embed指令指定要嵌入的文件或目录；3.编译时资源被直接打包进二进制文件；4.通过fs.Sub创建子文件系统以正确访问资源路径；5.可启动HTTP服务器直接服务内嵌资源。常见用法包括内嵌单个文件、多个文件、整个目录（递归或非递归）。使用时需注意控制文件体积、处理路径差异、平衡开发与生产环境需求，并明确其不适用于动态资源更新场景。
