-
retract是模块根go.mod中声明式屏蔽旧版本的机制，仅影响下游执行gomodtidy时的依赖选择，不删除远程版本或改变go.sum；须配合新版本发布才能使@latest生效。
-
MySQL中NULL表示“缺失”而非“空”，Go的string和*string无法安全接收，因database/sql驱动不自动转零值，必须用sql.NullString等类型或SQL层COALESCE/IFNULL处理。
-
Go程序默认能跑满CPU，所谓“没跑满”通常是因I/O、锁、GC或串行逻辑阻塞goroutine；runtime.GOMAXPROCS默认为逻辑核数，仅在cgroup限核未感知或早期初始化时需干预，错误设置会引发调度开销或资源浪费。
-
context.WithCancel是并发取消的唯一可靠方式，因其通过ctx.Done()返回只读channel实现跨goroutine同步取消通知，避免手写标志导致的响应延迟、竞态和清理遗漏。
-
倒排索引用map[string][]int而非[]string，因文档ID必须为整数以避免GC压力，[]int内存连续、append高效、cache友好；中文分词推荐gse，需过滤单字、停用词，并预分配slice容量。
-
在Go程序中忽略特定错误时，需使用errors.Is判断错误是否为预定义值，或用errors.As转换为具体类型。例如：1.errors.Is用于检查错误是否等于os.ErrNotExist等固定值；2.errors.As用于提取结构体错误类型的字段或方法，需传入指针类型；3.应避免直接比较错误字符串，自定义错误时需导出指针类型以便外部调用者使用。
-
在Go项目中导入本地包需先用gomodinit初始化模块并声明module路径，再按“module路径+子目录”格式绝对导入，如import"example.com/myapp/internal/utils"，禁止使用相对路径或无前缀导入。
-
Go并发计数器该用atomic.AddInt64还是sync.Mutex绝大多数场景下，优先用atomic.AddInt64——它快、轻量、无锁，且能正确保证计数器的原子性。只有当你需要「复合操作」（比如“读+判+写”）或计数器只是更大临界区的一部分时，才考虑sync.Mutex。哪些操作不能靠atomic完成，必须上Mutexatomic只保证单个操作的原子性，不提供「多步逻辑的原子封装」。一旦涉及条件判断或依赖当前值做决策，atomic就力不从心了。「如果计数器小
-
reflect.Value.Interface()panic因调用空Value，须确保Value已绑定数据（如reflect.ValueOf(x)或reflect.New(t).Elem()）；StructTag需用Tag.Get("inject")提取；Kind()判断类型类别，Elem()层层展开；函数注入需防循环依赖。
-
本地开发用单节点nats-server即可，默认监听0.0.0.0:4222；Go客户端需显式配置重连策略，启用JetStream后须立即创建jetstream.Context，凭证应通过nats.UserCredentials加载文件而非硬编码URL。
-
SetMaxOpenConns应设为数据库max_connections的60%～80%，兼顾QPS、平均耗时与余量，并配合SetMaxIdleConns（1/2～1/3）、SetConnMaxLifetime（10～30分钟）和SetConnMaxIdleTime（5～10分钟）协同调优。
-
Go策略模式需接口值语义安全、避免nil指针panic；用泛型注册表替代map[string]any防类型擦除；Context不持策略指针而应传参；高频场景可改用StrategyFunc函数类型优化性能。
-
最直接安全的Base64编码方式是base64.StdEncoding.EncodeToString()，它将[]byte转为标准Base64字符串（含+/=）；解码需处理*base64.CorruptInputError，URL安全场景应使用URLEncoding或RawURLEncoding。
-
http.ListenAndServeTLS(addr,certFile,keyFile,handler)是最简HTTPS启动方式，需PEM格式证书链与无密码私钥，参数顺序不可错；自动续期推荐autocert并持久化Cache；本地开发用mkcert生成系统信任证书。
-
直接用gobreaker——它是Go社区最成熟、被grpc-go和go-zero等生产级框架验证过的实现，自己手写易漏并发安全、滑动窗口计数、超时重置等关键细节。
