-
使用Gin框架开发RESTfulAPI的步骤如下：1.初始化项目并安装Gin，创建主文件并实现基础路由；2.定义带路径参数的GET接口获取用户信息；3.使用结构体绑定JSON数据处理POST请求；4.利用路由分组组织API路径；5.添加中间件实现日志记录功能。通过以上步骤即可快速搭建一个基础的RESTfulAPI服务。
-
围绕 Go 1.23 range-over-func、iter.Seq/Seq2、yield 返回值、提前停止和 slices.Collect，讲清 Go 迭代器在库 API 与业务代码中的落地边界。
-
Go应用容器化需多阶段构建并禁用CGO、指定GOOS、静态链接；选scratch或alpine镜像时注意SSL/DNS差异；K8s探针须区分就绪与存活态；必须设置GOMEMLIMIT适配cgroup内存限制。
-
rate.Limiter是生产级令牌桶实现，支持突发、线程安全、无锁；常见误用是混淆速率与桶容量；推荐复用而非每请求新建；漏桶适合后台任务而非HTTP接口。
-
gomodtidy删除未被import的依赖是正常清理行为，只保留代码中实际引用的包；未import的依赖即使手动添加也会被移除。
-
命令模式在Go中本质是接口抽象，即定义Command接口并让业务操作实现它，核心在于封装请求与执行逻辑分离，通过依赖注入和commandrunner实现解耦与可测试性。
-
bufio.Scanner默认按行分割，需用Split函数自定义分隔逻辑；SplitFunc须处理data不完整和atEOF状态，正确实现三步：找分隔符、切token、更新剩余数据。
-
trace_id为空主因是context未透传到位；HTTP入口须用私有struct{}作key注入，zap需封装WithContext自动提取，goroutine和DB调用必须显式传ctx，HTTP/gRPC出站需双写header/metadata。
-
在Go中重命名文件无需预先打开文件；若因业务需要必须先读写文件，则应显式关闭再重命名，避免defer重复关闭或重命名失败——关键在于合理安排Close()调用时机，而非绕弯封装。在Go中重命名文件无需预先打开文件；若因业务需要必须先读写文件，则应显式关闭再重命名，避免defer重复关闭或重命名失败——关键在于合理安排Close()调用时机，而非绕弯封装。Go的os.Rename()是一个纯路径操作函数，它仅接收两个字符串参数（
-
Gin本身无内置优雅关闭，需用http.Server.Shutdown()配合signal监听和context超时，手动管理所有goroutine退出；漏掉任一环节（如ticker、DB、Redis或子goroutine未响应ctx.Done）将导致进程卡住。
-
必须自己实现net.Listener才能实现连接控制，因http.Server不暴露连接池、不提供连接列表、也不支持主动关闭单条连接，仅无条件接受conn并启goroutine处理，需通过包装Listener拦截Accept()和Close()来接管全生命周期。
-
推荐用sync.Map+独立chan+context.Context实现内存级Pub/Sub：sync.Map避免并发写panic和迭代器失效，Range快照语义确保发布一致性；须封装value为struct并避免在Range中Load/Store；每个订阅绑定context防goroutine与channel泄漏。
-
Go闭包是匿名函数引用外层局部变量且逃逸出定义作用域时自然形成的行为；其捕获变量引用而非值快照，导致多个闭包共享同一内存地址。
-
应统一用len(s)==0判断切片是否为空，而非s==nil；因nil切片和空切片len均为0且len()调用安全，而s==nil仅适用于具体切片类型、在interface{}或泛型中会编译失败，且JSON序列化语义不同。
-
swaginit报错主因是缺失或格式错误的//@title等注释，必须位于main包文件中且连续无空行；类型需显式import、结构体及字段均须首字母大写并带jsontag；docs目录须与二进制同级；CI中需指定-g入口文件路径。
