-
必须先用prometheus.MustRegister()将自定义指标注册到默认收集器，否则/metrics不会暴露；注册须在http.ListenAndServe()前完成，且不可重复调用，否则panic。
-
Go测试网络错误需用MockHTTPClient模拟异常，如超时、连接拒绝、5xx状态码、空body、JSON解析失败等，通过自定义RoundTripper或httptest.Server精确控制响应，并断言具体错误类型确保覆盖边界。
-
必须配置GOPRIVATE环境变量，否则Go工具链将私有模块误作公开模块经proxy访问而失败；还需配合Git认证配置和GOSUMDB=off或+insecure以解决拉取、校验及CI/CD问题。
-
Go程序容器内CPU忽高忽低主因是GOMAXPROCS未对齐CPU配额：运行时读取宿主机逻辑CPU数而非容器实际限额，导致goroutine在受限核上争抢；需通过cgroups或DownwardAPI动态设置GOMAXPROCS。
-
Wire是编译前生成注入代码的工具，要求wire.go带//+buildwireinject标签、置于目标包内、仅含injector和wire.Build()调用；所有provider必须导出、签名清晰、无副作用，生成的inject.go需提交至Git。
-
Go调度器需通过问题驱动+打点验证理解，从runtime.main切入，聚焦schedule/findrunnable逻辑，结合GODEBUG观察状态流转，而非通读源码或深究汇编细节。
-
DeletedAt字段必须是*time.Time类型，因为GORM通过类型（指针）和标签双重判定逻辑删除；若用time.Time零值会被误判为已删除，导致全表过滤。
-
Go无法直接操作原生canvas，唯一可行路径是编译为WebAssembly并通过syscall/js调用浏览器CanvasAPI；需用requestAnimationFrame驱动动画，避免死循环，正确获取getContext('2d')，并推荐逻辑与渲染分离。
-
viper是Go最实用配置库，支持多格式、多来源、热重载及环境变量自动映射；需注意加载顺序（AutomaticEnv必须在ReadInConfig前）、结构体导出字段要求及优先使用Get+类型断言而非全量Unmarshal。
-
用docker-go连不上本地DockerDaemon时需显式指定host，Linux用unix:///var/run/docker.sock，Mac用unix:///Users/$USER/.docker/run/docker.sock，WSL2用tcp://localhost:2375并开启DockerDesktop相应设置。
-
在Go中定义返回时间的函数时，应直接返回time.Time类型而非字符串——这既符合类型安全原则，又能完整保留时间的语义能力（如比较、加减、格式化等），便于后续调用方灵活使用。
-
Go语言中，interface{}与反射结合可在运行时处理任意类型。通过reflect.ValueOf和TypeOf获取类型与值信息，利用Elem()解指针并调用Set修改数据；遍历结构体字段读取标签实现序列化等通用逻辑；通过MethodByName动态调用方法，支持插件式设计。示例包括修改指针指向值、解析structtag及调用导出方法。需注意仅导出字段和方法可被反射操作，且应避免滥用以减少性能开销和维护难度。
-
interface{}会让变量逃逸到堆上，因编译器无法确定底层类型大小和生命周期，保守地将原值复制到堆；常见于传给fmt.Println、json.Marshal等接受interface{}的函数。
-
Go中不能直接用reflect.Method调用结构体方法，因其仅为元信息；须通过reflect.Value.MethodByName()获取可调用的reflect.Value后调用Call()，且仅支持导出方法和可寻址接收者。
-
用time.Truncate(24*time.Hour)最快获取本地时区今日零点，如需指定时区（如Asia/Shanghai）则先In()再Truncate；切勿缓存零点值，应每次实时计算或封装函数。
