-
使用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接口暴露分类检索与全文搜索能力。
-
bufio.Scanner默认按行分割，需用Split函数自定义分隔逻辑；SplitFunc须处理data不完整和atEOF状态，正确实现三步：找分隔符、切token、更新剩余数据。
-
trace_id为空主因是context未透传到位；HTTP入口须用私有struct{}作key注入，zap需封装WithContext自动提取，goroutine和DB调用必须显式传ctx，HTTP/gRPC出站需双写header/metadata。
-
Go 里 Mutex 和 channel 不是谁绝对更快。保护一个共享变量时，Mutex 往往更直接；交接任务、串联 worker、表达所有权转移时，channel 更自然。判断时别只盯 ns/op，要看临界区、队列等待和业务动作。
-
直接用crypto/aes会panic是因为其仅提供底层原语，要求密钥必须为16/24/32字节且IV长度固定（如CBC需16字节），字符串未转[]byte、长度不符或含非法字符均触发invalidkeysize或missingIV错误。
-
main.go应放在cmd/子目录下（如cmd/myapp/main.go），根目录仅保留go.mod等元信息；internal/是Go强制的访问边界，用于封装不对外承诺的实现；API层负责错误映射为HTTP状态码，domain层只定义业务语义错误；go.mod的module名应为最终导入路径（如github.com/user/repo）。
-
批量重命名须校验路径合法性：用filepath.Clean并检查前缀，过滤非法字符；用filepath.WalkDir避免软链风险；每步用临时名实现原子重命名；跨盘符时改用copy+remove并补全元数据。
-
Go地理围栏核心是用github.com/paulmach/go.geo判断点是否在多边形内，需注意球面几何、顶点顺序、坐标顺序、状态缓存、空间索引优化及跨日期变更线处理。
-
准确监控消息积压需聚焦消费者视角滞后量：RabbitMQ用queuedepth+unackcount，Kafka避offset提交延迟取log_end-comitted_offset，NSQ重in_flight与requeue_count；须区分瞬时尖刺与持续恶化，动态基线告警。
-
连接Couchbase需传节点地址（如"127.0.0.1"）而非URL，显式配置用户名密码，TLS需手动设；Bucket须预创建并授权；操作用Upsert非Insert；Get需手动解析JSON并判err。
-
MD5和SHA是单向哈希算法，不可逆，仅用于校验或密码加盐；AES是对称加密算法，支持加解密，推荐使用AES-GCM模式。
-
飞书机器人Webhook地址必须以https://开头且无空格或换行，需用strings.TrimSpace()清洗并校验前缀；日志告警应通过异步Hook实现，避免阻塞主流程。
