-
Go测试函数必须命名为Test且参数为testing.T，需置于*_test.go文件中、同包内，子测试名禁用斜杠和空格，测试文件应保持纯净以避免意外依赖。
-
DFS拓扑排序结果逆序是因递归退出时记录节点，此时所有后继已处理完，天然满足前置依赖优先；需reverse得正序，或改用BFS法避免栈溢出。
-
ArgoCD的Application资源需显式定义在Git仓库中（如apps/my-service.yaml），由AppProject授权部署，spec.source.repoURL必须是集群可访问地址，spec.destination.namespace不可省略，默认default常导致同步失败。
-
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
-
最稳妥方案是直接使用gobreaker库，它被go-zero和kratos验证成熟，支持滑动窗口统计、半开探测且无外部依赖；需正确配置MaxRequests（≥10）、Timeout（15s）、Interval（30s～2m），并在客户端调用处用cb.Execute包裹Do操作，配合context.WithTimeout和fallback降级，同时暴露指标便于观测。
-
RedisPubSub容易丢消息，因其非线程安全、默认缓冲区仅10条、无超时控制易卡死goroutine、重连不自动恢复订阅、无ACK机制且panic或慢处理会导致缓冲区溢出。
-
用status.Errorf包裹错误才能保留原始状态码；status.FromError只识别status.Status实例，其他包装会导致code降级为Unknown，自定义错误需实现GRPCStatus()方法返回真实status.Status。
-
Consul高负载导致Go网关连接重置，根本原因是Server连接处理能力不足与客户端短连接、无超时、无复用等默认行为不匹配；需强制复用连接、设超时与降频检查，并优化Server配置及规避Go代码陷阱。
-
本文详解通过GitURL重写机制，让goget支持基于SSH地址（如git@1.2.3.4:group/repo.git）的私有GitLab仓库，解决Go原生不识别SSH格式导入路径的问题。
