-
GOOS和GOARCH必须显式设置才能交叉编译；CGO_ENABLED=0是关键开关，否则依赖C库会导致链接失败；含import"C"的代码需配对应C工具链或替换为纯Go实现。
-
Viper初始化后读不到config.yaml是因默认只在当前工作目录查找，需显式设置路径；字段为空是因未用mapstructuretag匹配YAML键名；AutomaticEnv()不生效是因环境变量名未按DATABASE_HOST规则命名；WatchConfig()仅通知变更，不自动刷新已绑定值。
-
用minio-goSDK连MinIO并上传文件：初始化客户端需endpoint、accessKey、secretKey和secure选项；桶需显式MakeBucket创建；上传用PutObject，传入io.Reader并确保文件指针在开头。
-
可设置性指reflect.Value能否修改底层值，需通过reflect.ValueOf(变量地址).Elem()获取并调用CanSet()判断，仅当变量可寻址且非未导出字段时返回true，否则Set()将引发panic。
-
用colly而非手动组合http.Client+goquery，因其内置反爬、重试、并发控制、去重、Cookie管理及robots.txt遵循等能力；但不支持JS渲染，需注意v2兼容性、状态码检查、合理限速与数据缓冲。
-
HTTPServer默认并发足够，但I/O阻塞（如API调用、DB查询）会导致goroutine挂起、调度压力上升；应通过pprof定位瓶颈，用context超时、信号量限流、结构化日志等优化。
-
otel.Tracer不能全局复用一个实例，因其按名称隔离追踪上下文，共用名称会导致span冲突、属性覆盖、采样策略失效；应按服务/模块使用专属名称如"user-service"，并通过依赖注入或context传递，避免包级缓存。
-
Go反射无法访问私有字段，必须用unsafe.Offsetof计算偏移量配合unsafe.Pointer读取，但存在跨平台不稳定、内存安全风险及维护成本高等问题。
-
需手动按RFC1035构造DNS查询包：初始化12字节头部→域名label-wise编码（长度字节+标签+0x00）→写QTYPE/QCLASS（uint16大端）→UDP发送（≤512字节）。
-
Gomodules是Go1.11引入的依赖管理机制，默认仅在GOPATH外启用；需确保项目不在$GOPATH/src下，执行gomodinit初始化，再用gomodtidy或gobuild自动下载并记录依赖，replace用于临时替换依赖但不可提交至生产环境。
-
在Go语言中，区分context取消与超时错误的关键在于比较错误值。1.使用errors.Is(err,context.Canceled)判断是否为主动取消；2.使用errors.Is(err,context.DeadlineExceeded)判断是否为超时取消。这两种错误需不同处理：主动取消常见于手动调用cancel()或客户端断开连接，通常不作为系统异常上报；超时取消则可能提示服务响应过慢，需进一步分析。此外，在HTTP服务中应提前检测context状态以避免无效操作，并将ctx传入下游调用以支持链路
-
为什么直接用github.com/bwmarrin/snowflake会出错？因为它的Node实例不是线程安全的，且默认使用系统时间做基准，本地时钟回拨会导致ID重复或阻塞。很多新手一上来就node.Generate()，结果在并发场景下拿到重复ID或panic。必须为每个goroutine独立创建Node，或加锁共享（不推荐）time.Now().UnixMilli()在容器或虚拟机里可能跳变，要配合sync/atomic做单调递增兜底默认epoch是2019-01
-
Go调用FFmpeg命令行是最现实的音视频处理方式，因标准库无支持且纯Go库功能残缺、维护停滞或性能差；推荐用os/exec直接调用，注意超时控制、stderr读取、绝对路径和避免Output()内存溢出。
-
Go语言通过value,ok:=interface{}.(Type)安全检视接口值的具体类型，非强制转换；支持typeswitch批量判断，仅适用于接口类型，断言开销小但需避免重复，nil接口断言依目标类型而定。
-
短链接系统必须用数据库主键ID映射为短码（如base62），而非哈希截断；需预留扩展字段、区分301/307重定向、异步更新点击数以保障高并发下的正确性与性能。
