-
swaginit生成docs/失败需检查三件事：一要确保已安装swagCLI工具；二须在项目根目录执行命令；三所有handler函数必须含完整注释块且以//@Summary开头。
-
命令模式通过将请求封装为对象，实现操作的参数化与日志追踪。在Golang中，定义Command接口并创建LoggedCommand装饰器，在执行前后自动记录日志，支持耗时统计与错误捕获，适用于审计与调度场景。
-
方法值t.Set是闭包式函数，类型为func(int)，接收者已固化；方法表达式T.Set是普通函数，类型为func(*T,int)，需显式传接收者。二者类型、参数、调用方式均不同，混用将导致编译失败。
-
time.Timer适用于一次性延时任务，如5秒后发送通知；需周期性执行应使用time.Ticker。通过NewTimer创建后，可监听其C通道等待触发，用Stop停止以避免资源泄漏，Reset可重设超时时间，常用于连接保活等场景。注意Stop后需处理C通道残留值，已触发的Timer需Reset才能复用，单次延迟可用更简洁的time.After。
-
不用map而用布隆过滤器是因为内存更省：上亿字符串查重时，map需几百MB，布隆过滤器仅几MB，代价是允许极小误判但绝不漏判，适合前置过滤如消息去重、URL去重等。
-
使用zap等结构化日志库统一Golang微服务日志格式，通过Filebeat采集日志并经Kafka缓冲后送入Elasticsearch存储，结合Kibana实现集中查询与可视化分析，同时注入trace_id、service_name等字段支持链路追踪与多维筛选，构建高效、可扩展的日志聚合体系。
-
Go语言虽无语法级装饰器，但可通过高阶函数（如func(http.Handler)http.Handler或泛型func(T)R）实现等效功能；HTTP中间件需正确传递响应参数并显式调用next.ServeHTTP(w,r)，通用装饰器需注意泛型约束、并发安全与性能开销。
-
json.Marshal仅序列化首字母大写的导出字段，小写字段被忽略；需改名或用jsontag控制，omitempty跳过零值，"-"完全忽略，time.Time默认RFC3339字符串，加stringtag可输出带引号字符串，时间戳需自定义MarshalJSON。
-
govet是Go工具链自带的语义分析检查工具，专查语法合法但逻辑可疑的代码，如printf参数不匹配、range复制结构体、struct标签拼写错误、未用变量、WaitGroup调用顺序错误等。
-
nilmap是未初始化的map，不能写入但读取安全；空map用make初始化，可读写。需写入时应使用空map，仅判断存在性可用nilmap。
-
必须手动判断参数有效性再拼接WHERE条件，避免空字符串、零值、nil等误入SQL；推荐用切片累积条件+strings.Join拼接，并动态处理IN子句占位符。
-
io.Pipe是Go中用于goroutine间同步数据传输的管道，实现io.Reader和io.Writer接口，支持单向通信、阻塞读写及错误传递，常用于内存流处理。
-
Go适配器模式通过组合与接口转换实现，而非继承；适用于无法修改第三方/遗留代码但需匹配自定义接口的场景，核心是包装行为、转换接口形状。
-
replace指令可用于替换Go模块依赖，支持本地路径、远程分支或私有仓库；例如将github.com/user/mylib替换为本地目录../mylib进行调试，或指向特定版本、commit及私有镜像地址；使用时在go.mod中添加replace语句并运行gomodtidy更新依赖，注意避免提交临时路径导致构建失败。
-
Go的database/sql标准库不支持单次执行含多个分号分隔的SQL语句，需手动拆分并逐条执行（推荐在事务中完成），或使用成熟的数据库迁移工具如goose或rambler。
