-
swaginit生成的docs中无接口，因swag仅扫描带Swagger注释（如//@Summary）的具名handler函数，不解析Gin运行时路由；需确保注释紧邻函数、格式正确、docs包被下划线导入且ginSwagger.WrapHandler正确注册。
-
通过NetworkPolicy、RBAC、mTLS和Golang中间件实现Kubernetes微服务安全：1.用NetworkPolicy限制Pod间通信；2.在Golang应用中集成安全中间件防御攻击；3.借助Istio服务网格启用mTLS加密服务间通信；4.遵循最小权限原则配置RBAC与ServiceAccount，确保全流程安全可控。
-
直接在每个函数写iferr!=nil会重复冗长、淹没业务逻辑，且难以统一加日志、重试或转HTTP状态码；defer+panic不可行，因panic不处理普通error、破坏栈、影响性能，且Go官方反对；可行方案是中间件模式+分层错误封装：定义带Code/Message/Status/Err的AppError类型，并在handler入口统一处理，同时用%w保持错误链、避免context.Value传traceID。
-
Go中数组固定长度、值类型，切片动态灵活、引用底层数组；数组初始化需指定长度如[3]int{1,2,3}，切片用[]int{1,2,3}或make([]int,3)；截取切片共享底层数组，索引越界会panic。
-
go-redis连接池过小致高并发超时，需设PoolSize=QPS×RT×2并配MinIdleConns；SetNX锁须带过期时间、用随机value及Lua校验解锁；Pipeline禁用WATCH/EXEC等命令，大体积数据需分批；v9版强制context、Protocol适配及健康检查。
-
Go选Serverless框架应优先支持http.HandlerFunc复用、避免强绑定网关，冷启动优化关键在延迟init操作、精简二进制，并根据云厂商直选aws-lambda-go而非过度抽象的gofaas。
-
Go标准库不支持WebDAV，需用第三方库如go-webdav并严格实现RFC4918协议、XML响应格式、权限校验、锁机制及客户端兼容性处理。
-
Go程序必须有且仅有一个funcmain()，位于packagemain中，无参数无返回值；编译器硬性检查，违反即报错。
-
WebSocket连接必须用gorilla/websocket，因标准库不支持帧解析、心跳等核心功能；正确升级需upgrader.Upgrade()，并配置Origin校验、Ping/Pong及Nginx代理头。
-
gorilla/schema默认不递归解析嵌套struct，需显式注册converter；数组须用Tags[0]格式命名；time.Time需手动注册转换器；避免与ParseForm混用。
-
Go的html/template包能自动转义输出内容，防止XSS攻击。根据上下文（文本、属性、JS、URL等）自动应用转义规则，无需手动调用EscapeString。例如在HTML标签或属性中，特殊字符如<、>、"、'会被转义为实体；在JS字符串或URL中也会相应处理。使用时应始终以字符串传递用户输入，避免滥用template.HTML，仅对可信HTML使用该类型，否则可能导致XSS漏洞。只要正确使用，不随意绕过转义机制，即可有效防御大多数XSS风险。
-
直接用channel+map实现Pub/Sub易崩，因channel不支持广播、易死锁或漏事件，且subscriber崩溃后publisher仍发数据导致panic；应引入dispatchergoroutine和sync.Map管理订阅，用泛型约束payload类型防类型擦除。
-
在Go中，结构体字段修改需通过指针实现，因结构体为值类型，传值会复制副本，修改不影响原数据；传指针可直接操作原始结构体，避免内存拷贝，提升效率。定义方法时使用指针接收者才能修改字段，值接收者仅作用于副本；嵌套结构体也需逐层通过指针访问，注意判空防panic。
-
内存逃逸指变量被分配到堆而非栈，由编译器逃逸分析决定，导致GC压力增大、分配开销上升、缓存局部性变差；在Go高并发场景下，大量goroutine触发堆分配会显著增加GC频率和STW时长，降低吞吐并推高延迟。使用gobuild-gcflags="-m-l"可查看逃逸详情，常见提示如“escapestoheap”“leakingparam”“movedtoheap”表明变量逃逸。结构体设计不当是主因：含指针字段（如*bytes.Buffer）、过大（>64字节）、返回取地址值、传入接
-
gofpdf中文显示为方块因未正确加载中文字体，需NewCustom创建实例、AddFont后SetFont、路径用正斜杠；AddLink须在AddPage后立即调用；表格用MultiCell并设足够行高；Save前需确保目录存在。
