-
zk.Connect不panic的关键是：传全地址列表、设5秒以上超时、连接后立即用State()检查是否为StateConnected，不能仅依赖err==nil。
-
生产环境应选用官方go-elasticsearch/v7客户端，需显式调用Do()、按字节而非条数切分bulk、解析聚合时先取键再断言类型。
-
swaginit需显式指定多目录路径并严格遵循注释格式：-g指定入口文件，-d列出internal/handler等子包；注释字段名、缩进、空格须精确匹配；泛型需手动@Schema声明；Nginx部署注意alias末尾斜杠。
-
Go函数参数永远传值，slice/map/chan因底层含指针字段而表现类似引用；array纯值类型，修改不影响原值；用指针参数需满足修改需求、大对象避免拷贝或接口要求指针接收者。
-
trace.Start()必须显式调用且配对trace.Stop()，否则trace.out为空或仅有头尾事件；常见原因包括未传*os.File、Stop未执行、程序过快退出、Start放置过晚。
-
Sync.Map不能用反射遍历，因其内部字段未导出且未实现迭代接口；必须通过Range()等公开API访问，注意nil检查、类型转换安全及性能陷阱。
-
Go语言中处理异常和错误的方式主要依赖于error返回和panic/recover机制。1.error返回用于常规错误处理，函数通过返回error值让调用者处理或忽略错误，适用于可预见的问题，如文件打开失败、网络请求超时等；2.panic用于触发运行时异常，程序沿着调用栈回溯，直到崩溃，适合处理不可预料的错误，如数组越界、空指针访问；3.recover只能在defer函数中使用，用来捕获panic，防止程序崩溃，常用于中间件统一拦截异常、测试代码模拟异常行为以及初始化阶段的关键错误处理；4.使用error
-
gomodinit初始化模块时模块名必须是合法导入路径；写错需手动修改go.mod或用gomodedit-module修正；本地引用未发布子模块用replace并及时清理；GO111MODULE=on虽默认启用，但目录无go.mod、路径含空格或goget无域名时会退回到GOPATH模式。
-
Go语言以包为作用域单元，包名须小写、简短、语义明确，避免util等泛化名，推荐按功能聚类如payment、domain，版本升级应通过模块路径而非子目录或自造包名。
-
应使用errors.Is和errors.As替代==判断错误类型，因其可穿透多层%w包装；自定义错误需显式实现Unwrap方法；推荐defer统一处理错误，避免循环中重复判断。
-
slice中存指针易引发数据竞争，因循环变量地址复用（如&i）导致所有指针指向同一内存；正确做法是取可寻址变量元素地址（如&data[i]），并确保其生命周期足够长。
-
iota是Go中仅在const块内有效的编译期整型常量生成器，每块从0开始逐行递增，同行共享值；可显式赋值实现偏移、步长或非连续序列。
-
当自定义error类型的Error()方法内部调用fmt.Sprint(e)时，会因fmt包优先调用Error()接口导致递归调用，最终栈溢出；根本原因是fmt在格式化interface{}值时按固定优先级（error→Stringer）选择字符串化方法。
-
Go反射不可替代接口和泛型，但用于序列化、配置绑定等绕过编译期类型约束的场景；必须用reflect.Value.Interface()再断言以避免未导出字段panic；StructTag需用反引号、区分大小写、不自动继承嵌入tag；DeepEqual对函数恒false、map顺序敏感、不调用Equal方法。
-
应使用zap替代标准log包实现结构化日志：通过lumberjack轮转文件，按环境动态配置输出格式（dev用Development，prod用Production），显式Sync()避免丢失日志，禁止裸print，敏感字段需脱敏。
