-
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.减少日志开销：去除冗余、结构化输出、高频日志采样。需持续调优以避免性能瓶颈。
-
panic仅用于程序无法继续运行的致命错误，如强依赖配置读取失败、数据库连接池初始化失败、类型断言必然成功却失败、关键全局状态被破坏；常规错误（HTTP失败、输入校验不通过等）必须用error处理。
-
默认GoDocker镜像体积大（800MB+）是因为包含完整开发工具链，而distroless静态镜像仅含内核接口、静态链接二进制和必要运行时，体积仅2–3MB，需禁用CGO并静态编译。
-
Go语言只有值传递，但可通过指针模拟引用行为；传指针仅复制地址（8字节），避免大对象拷贝，且能修改原值；需根据是否需修改、拷贝成本及方法接收者需求决定是否用指针。
-
Go的http.Client默认不重试，需手动实现；仅对幂等请求和特定网络错误（如net.OpError）重试，配合指数退避加jitter、最大次数/时间限制，并用backoff库更稳妥。
-
Go模块使用语义化版本vX.Y.Z管理依赖，X为不兼容API变更，Y为新增功能，Z为问题修复；主版本≥2时需在导入路径添加/vN后缀，确保版本共存；预发布版本如v1.0.0-beta不被默认选用，建议生产环境使用稳定版本。
-
Go语言允许在for循环内部用:=重复声明外部已定义的同名变量，这是因为每次声明都发生在独立的作用域内，实际创建的是新变量而非覆盖原变量，这种现象称为“变量遮蔽”（variableshadowing）。
-
Go1.20+应使用rand.New(rand.NewSource(42))创建确定性PRNG实例，并将其作为参数注入被测函数，避免依赖已弃用的rand.Seed()或全局rand状态，确保测试可重现。
-
goroutine泄露典型表现为内存持续上涨、pprof显示大量runtime.gopark状态goroutine、HTTP响应变慢但CPU不高；主因是未监听ctx.Done()导致goroutine卡在select或time.Sleep中无法退出。
