-
飞书机器人Webhook地址必须以https://开头且无空格或换行，需用strings.TrimSpace()清洗并校验前缀；日志告警应通过异步Hook实现，避免阻塞主流程。
-
使用json:"-"标签可完全忽略结构体字段的JSON反序列化，支持单独使用、与其他标签组合、嵌套结构体中局部忽略，也可通过空接口或自定义UnmarshalJSON方法实现动态控制。
-
Go的map并发写会panic，因运行时检测到concurrentmapwrites；sync.Map适用于读多写少场景，而sync.RWMutex+泛型map更灵活高效。
-
必须手动判断参数有效性再拼接WHERE条件，避免空字符串、零值、nil等误入SQL；推荐用切片累积条件+strings.Join拼接，并动态处理IN子句占位符。
-
HTTP接口404是因为未调用RegisterXXXHandlerFromEndpoint注册路由；该函数必须在http.ListenAndServe前显式调用，且ctx不可提前cancel、endpoint需指向已启动的gRPC服务。
-
当任务需周期性重复执行时，应优先使用time.Ticker；它自动维持固定间隔的时间事件流，资源开销低，而time.Timer仅适用于单次延迟或需严格串行节拍的场景。
-
在Go中使用Protobuf定义RPC需先编写.proto文件，用service声明服务及方法；2.通过protoc生成Go代码，包括消息结构体和服务接口；3.实现服务端结构体并注册gRPC服务；4.客户端通过Stub调用远程方法，完成通信。该流程支持跨语言、高效率的微服务交互。
-
高并发下本地磁盘IO瓶颈无法靠增加goroutine解决，必须解耦I/O与CPU工作：单goroutine顺序读+合理缓冲（如64KB）+按逻辑边界分块处理，避免多goroutine争抢同一文件导致寻道恶化。
-
Excelize/v2是当前Go生态处理.xlsx最可靠的选择，但高度依赖文件合规性、写入方式与类型处理：不支持非标格式，中文需UTF-8，大批量须用SetSheetRow或StreamWriter，读公式/日期须判类型并手动计算。
-
直接用tikv.RawClient会连不上集群，因其不自动读取PD地址、不做服务发现，仅依赖硬编码的PDendpoints；若地址错误或未配TLS/网络不通，连接将超时而非报明确错误。
-
Go1.18+泛型interface最简语法是typeName[Tany]interface{...}，T为类型参数，any是约束而非别名，Container[int]与Container[string]是不同类型，不可互赋。
-
Go允许单goroutine内对无依赖赋值（如a=1、b=2）重排序以优化性能，本goroutine内不可观察；但跨goroutine时若无同步（如channel关闭），可能观测到b=2而a=0，因缺乏happens-before关系。
-
Go语言允许编译器和处理器在单个goroutine内对无依赖的内存写入操作进行重排序，只要不改变该goroutine内部的语义；但若缺乏显式同步（如channel、mutex、atomic或sync.WaitGroup），其他goroutine可能观察到违反代码顺序的值更新。
-
连接未复用是因为Keep-Alive需客户端和服务端协同生效，常见原因包括：Transport未配置MaxIdleConnsPerHost、未调用resp.Body.Close()、IdleConnTimeout过短，或Client未复用导致连接池失效。
-
Excelize多Sheet操作需注意三点：NewSheet仅返回索引不激活，须用SetActiveSheetIndex显式切换；写入/读取若无Sheet前缀则作用于当前活动页；推荐统一用"Sheet!A1"格式或透传索引避免错位。
