-
go-swagger生成失败：找不到swaggergeneratespec命令根本原因是go-swagger没装对，或没进$PATH。它不是goget直接装完就能用的二进制工具，得手动下载预编译版本或从源码构建。实操建议：优先用官方推荐方式：curl-sSLhttps://raw.githubusercontent.com/go-swagger/go-swagger/master/install.sh|sh，它会自动下载、校验、放进$GOPATH/bin确认$GOPATH
-
JWT中间件必须显式校验exp和iat，否则过期Token仍被接受；权限不应存于JWT而应查Redis缓存；路径需归一化处理；用户Token与服务Token须严格隔离。
-
自定义错误结构体通过实现Error方法携带错误码、时间戳等信息，结合工厂函数和errors.As进行类型判断，可扩展StatusCode、IsRetryable等方法，提升Go错误处理的可编程性与灵活性。
-
Go1.18起原生支持覆盖率引导的模糊测试，需写合规fuzz函数（单参数*testing.F）、提供有效种子语料、在Fuzz闭包中做断言并合理约束运行时长与资源。
-
GitHubActions中gotest卡住主因是未设超时及遗留goroutine，须加-timeout60s、用httptest.NewUnstartedServer、跳过真实DB连接；发布失败因路径权限错，需清理dist并设GITHUB_TOKEN写权限；私有模块拉取失败因漏配GOPRIVATE和go.sum缓存key。
-
模块发布前必须设置正确的go.mod文件，其modulepath需与代码托管地址一致（如github.com/yourname/yourmodule），打tag必须为vX.Y.Z格式，且需在全新环境验证goget和gobuild是否正常。
-
异步写入避免阻塞：通过内存缓冲和独立goroutine解耦日志写入；2.合理轮转策略：按大小轮转、限制备份数、延迟压缩；3.优化库配置：调整lumberjack的MaxSize、MaxBackups，复用文件句柄；4.减少日志开销：去除冗余、结构化输出、高频日志采样。需持续调优以避免性能瓶颈。
-
使用errgroup.Group可实现并发任务的错误聚合，遇到首个错误即返回；若需收集所有错误，可用带缓冲channel或sync.WaitGroup配合互斥锁保护错误切片，推荐优先使用errgroup或channel以避免竞态条件。
-
Go用结构体嵌入和接口隐式实现替代继承，将复用与替换解耦：嵌入是字段方法的自动提升而非类型继承，接口满足由方法签名决定且无需声明，组合显式暴露依赖并强化职责边界。
-
围绕 Go 1.24 新增的 os.Root、OpenInRoot 和 Root.Open，讲清路径遍历防护、符号链接边界、文件上传、安全解压、测试用例和老项目迁移方式。
-
Go中指针本身不提升JSON序列化性能，但影响零值处理、内存布局和语义表达；应基于“未设置/零值”区分等业务需求使用指针，而非追求性能。
-
直接复制go.mod和go.sum通常会失败，因其有效性依赖模块路径与项目根目录严格匹配；应仅提取require依赖、执行gomodinit、粘贴后运行gomodtidy，并正确配置GOPRIVATE处理私有仓库。
-
正确处理Go语言中客户端请求的响应错误需通过error类型显式传递，定义统一错误响应结构如ErrorResponse，并在各层间合理分类与转换错误。使用sendError函数返回JSON格式错误并设置HTTP状态码；采用分层错误处理策略，数据层返回具体error，服务层判断处理，Handler层映射为HTTP状态码；利用errors.Is和errors.As判断原始错误类型；自定义AppError结构体增强上下文追踪；通过Recoverer中间件捕获panic，防止服务崩溃并记录日志；最终实现对外信息简洁
-
gRPC流式传输支持四种模式：单项、服务器流、客户端流和双向流，适用于实时数据推送等场景；通过连接复用、keepalive配置、消息压缩、流控背压及性能监控等优化手段，可显著提升通信效率与系统稳定性。
-
Cursor生成的Go网络状态机代码类型不安全、测试覆盖不足、存在竞态与泄漏、缺乏Mock隔离——因用string定义状态致编译期无法校验非法赋值，测试仅覆盖主路径而忽略非法转移与并发场景，HandleEvent混入耗时操作且未用context管控生命周期，未抽象网络依赖接口导致测试不稳定。
