-
K8s调度器插件必须基于scheduler.Framework实现，因v1.22起旧算法已弃用；硬改默认调度器会导致升级覆盖、e2e失败；插件为独立二进制，通过--scheduler-name注册，需正确注册、命名并实现扩展点，避免热路径阻塞与归一化失真。
-
Go的sendfile零拷贝仅Linux原生支持，需源为*os.File、目标为net.Conn且未被中间件/TLS/HTTP/2包装；手动调用syscall.Sendfile需注意fd类型、偏移维护及错误处理。
-
Gotime.Timer高频创建/停止导致CPU突增，因最小堆频繁操作与timerLock争抢；建议复用Timer、启用timerwheel（GODEBUG=timerwheel=1）或仅在明确瓶颈时自研时间轮。
-
值接收者复制实例，适合小型结构体且不修改状态；指针接收者操作原对象，可修改字段、避免复制开销，适用于大结构体或需修改场景。选择依据为是否需修改数据、结构体大小及方法一致性，不确定时优先使用指针接收者。
-
flate压缩小数据变大是因deflate需嵌入Huffman表等元信息，100字节以下不建议压缩；Writer非并发安全，须每goroutine独用或sync.Pool配Reset；解压错误多因未Close导致流不完整，应加长度前缀或改用gzip。
-
Go中变量名重复导致的shadowing是真问题，因编译器静默复用或覆盖同名变量，引发逻辑bug却无报错警告；常见于:=声明、有名返回值、for循环及struct字段同名场景。
-
defer用于延迟执行资源释放，确保文件、连接等安全关闭；结合错误处理可避免关闭错误被忽略，需用匿名函数捕获并记录close错误，防止命名返回值被覆盖，多个defer按LIFO执行，应分别处理各资源关闭错误。
-
使用html/template自动转义、bluemonday过滤富文本、设置CSP等HTTP安全头是Golang防范XSS的核心措施，需在输出与输入阶段协同防御。
-
Go通过Goroutine和同步原语高效处理并发，使用sync.Mutex确保共享资源访问的原子性，避免竞态条件；在读多写少场景下采用sync.RWMutex提升性能；需合理控制锁范围与粒度，避免死锁；优先使用原子操作或channel进行通信，减少锁依赖，结合context实现超时控制，保障程序正确性与高并发性能。
-
embed.FS需经http.FS包装才能用于http.FileServer，且须注意路径匹配规则、空目录/隐藏文件被忽略、开发时无热更新等限制。
-
Golang通过net/http包的http.Header类型高效处理HTTP请求头，其本质是map[string][]string，支持多值头部。使用req.Header.Set()可覆盖指定头部的值，适用于如User-Agent等单值场景；而req.Header.Add()则追加值，适合需多个相同键名的场景，如X-Forwarded-For。该类型自动规范化键名（如转为首字母大写），确保符合HTTP标准。最佳实践中，应避免硬编码敏感信息，使用自定义http.Client管理超时与Transport，并
-
Protobuf解包慢的主因是proto.Unmarshal参数误用：未复用结构体、未预分配缓冲区、未启用DiscardUnknown、误用gogoprotounsafe_unmarshaler等；应改用对象池、切片预处理、官方protoc-gen-go生成代码、unsafe.Slice（仅限可信长度场景）并缓存字段映射。
-
服务注册须待gRPC和健康检查服务就绪后执行，避免过早注册导致调用失败；服务发现需容忍空列表与临时故障，采用降级地址、缓存及长轮询优化；etcd与Consul的Watch机制差异要求分别适配；gRPC默认resolver不支持动态权重，需自研balancer实现指标驱动路由。
-
必须为服务调用显式设置超时，独立配置熔断器，前置限流至网关，完整传播context；否则必然引发雪崩。
-
Go1.16+推荐用filepath.WalkDir替代Walk，因其按需读取、内存可控、可规避symlink循环panic，并支持错误处理与SkipDir；匹配文件名宜用filepath.Base+strings.Contains，避免正则滥用与路径误匹配。
