-
ListenAndServe默认不限于IPv4，实际行为取决于系统和Go版本；建议用"[::]:8080"显式启用双栈，并注意IPv4-mapped地址处理。
-
"websocket:theclientisnotusingWebSocket"错误源于HTTP请求缺少Upgrade头，常见于前端误用fetch而非newWebSocket、反向代理未透传Upgrade/Connection头、中间件提前读body或CheckOrigin拒绝非同源请求。
-
Go反射中需用Complex()获取complex128值再调real()/imag()，或Convert后断言取原精度；SetComplex()仅接受complex128且目标必须可寻址；JSON/gRPC需自定义序列化，反射处理复数务必先判Kind()。
-
Go反射获取方法需用reflect.TypeOf(obj).NumMethod()和Method(i)遍历导出方法；指针接收者方法须传指针类型；调用前须用IsValid()检查，且参数需包装为[]reflect.Value；非导出方法不可见不可调。
-
应避免在main.go中直接写业务，因Go无隐式依赖机制，会导致import循环、测试困难、难以维护；需遵循“main包极薄”原则，将逻辑下沉至internal/等分层目录。
-
Example函数必须以Example开头、无参数无返回值，且需放在同包的_test.go文件中；函数内须调用fmt.Println等输出语句，输出严格匹配//Output:注释后的内容，不可含未导入包或未导出标识符。
-
expvar.NewInt和expvar.NewFloat有效，但需确保变量被全局引用且命名合法；自定义struct应嵌入expvar.Map并Publish；/debug/vars需手动注册handler；生产环境可安全启用，性能开销极低。
-
embed只能嵌入当前包目录下的静态文件，需用//go:embed显式声明路径；读取时必须检查error，避免fs.ErrNotExist导致panic；SQL文件应小写+下划线命名，按前缀排序执行；需适配迁移库或手动维护版本记录。
-
单元测试只测函数逻辑、隔离外部依赖，集成测试连真实依赖但需可控可销毁；二者通过构建标签//go:buildintegration严格分离，子测试t.Run组织多场景用例并确保独立性。
-
优先选Node.js：内部管理后台、小程序轻量API、MVP验证期服务；Go更适合需稳定低延迟、严控内存或深度集成K8s/Envoy的场景。
-
使用ConfigMap挂载配置文件并结合fsnotify监听实现Go服务配置热更新，避免重启Pod。
-
使用openzipkin/zipkin-gov0.5初始化tracer并配对HTTP中间件是唯一稳定上报、形成跨服务链路的方法；其他库已归档且不兼容Zipkinv2API，会导致静默丢span或400错误。
-
更新Go依赖需通过goget结合gomodtidy等命令精准管理；常用gogetmodule@version更新特定版本，goget-u升级直接依赖至最新兼容版（不跨主版本），并用gomodtidy清理冗余依赖、同步go.sum，确保依赖一致性。
-
最稳导出方式是用excelize.NewFile()写数据后直接file.Write(w)，设Content-Type为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet、Content-Disposition带ASCII文件名，禁用SaveAs；字符串需设NumFmt:49文本格式，长数字加单引号，大文件用SetSheetRow批量写，严防中间件污染响应流。
-
Golang中反射与闭包结合可在运行时动态调用方法并注入上下文逻辑，如通过DynamicCaller函数为不同插件创建带日志功能的调用闭包，实现通用化、可扩展的系统处理。
