-
使用中间件记录HTTP请求日志，通过拦截请求获取客户端IP、方法、路径、状态码等信息，结合zap实现结构化JSON日志输出，并利用channel异步写入与lumberjack轮转日志文件，确保高性能与可维护性。
-
go-swagger默认不解析普通注释，仅识别紧贴导出函数上方的//swagger:route和//swagger:operation标签；struct需被显式引用且导出才能生成model；嵌入UI需手动挂载静态资源，推荐swag替代以简化流程。
-
rate.NewLimiter(rate.Limit,burst)的两个参数分别是令牌生成速率（每秒补充令牌数，float64）和桶最大容量（int），burst至少应与rate相当（如rate.Limit(10)配burst=10），过小导致首秒大量拒绝，过大则限流失效；rate<0.01时因纳秒精度丢失行为异常。
-
小文件用os.ReadFile但需严谨错误处理：检查err、区分错误类型、注意100MB隐式上限及UTF-8编码限制；大文件须用bufio.Scanner并调整缓冲区防超长行报错。
-
类型断言在汇编中仅是两次指针比较，Go编译器对x.(T)生成极简代码：读itab和data字段，用CMPQ比itab与T的类型描述符地址，相等则继续，否则跳fallback，无函数调用、无堆分配、不进runtime。
-
直接使用aliyun/aliyun-oss-go-sdk/ossSDK，避免手拼HTTP请求；初始化client常见panic或403因endpoint格式错误（须为https://oss-cn-hangzhou.aliyuncs.com）、凭据未走正确链路（须用RAM子账号+环境变量OSS_ACCESS_KEY_ID/SECRET或ECS角色）。
-
defer必须写在panic前面，因为defer是立即注册动作，将函数压入defer栈，而panic只执行已入栈的defer；若defer在panic后，则根本不会执行注册，自然不运行。
-
生产环境必须用pgxpool.Pool，因其支持连接复用、健康检查、自动重连和context取消；pgx.Connect和sql.Open+lib/pq均不满足高并发与稳定性要求。
-
开发用zap.NewDevelopment()（consoleEncoder、颜色、完整字段名），上线用zap.NewProduction()（jsonEncoder、字段压缩、采样），二者不可混用；误用会导致调试困难或日志膨胀。
-
Go二进制的符号表位于.pclntab段（旧版为.gopclntab），debug/gosym仅解析该自定义格式数据，不支持ELF/Mach-O头、C函数或strip后的二进制，且Go1.18+兼容pcsp压缩但旧版可能存在PCDATA差异。
-
os.Stat与文件读取不能直接拼凑可靠缓存，因存在三坑：ModTime精度不足（如NFS秒级）、符号/硬链接导致行为不一致、检查与读取非原子致竞态；应改用inode+dev（Linux/macOS）或FileID（Windows）作唯一标识，或轻量哈希内容，并用带LRU驱逐的结构体管理缓存。
-
sync.Pool不能替代局部变量，因其对象生命周期不可控，可能被GC清理或被其他goroutine获取，仅适用于临时可丢弃的中间对象，且每次Get后必须显式重置。
-
必须用syscall而非os的场景包括：调用未封装的系统调用（如memfd_create）、精确控制fd标志、fork-exec间fd操作、自定义信号处理；Syscall允许goroutine调度，RawSyscall绕过调度仅用于fork/exit等不可中断调用。
-
init函数在Go程序启动时自动执行，用于包初始化；每个包可定义多个init函数，按源文件字典序及函数出现顺序执行；先执行导入包的init函数且仅初始化一次，最后才执行main函数，适用于配置加载与全局变量初始化。
-
Golang微服务实现服务发现的核心在于服务注册、健康检查和发现三个关键步骤。1.服务注册：服务提供者启动时，将自身信息（如服务名、IP地址、端口）注册到注册中心；2.健康检查：注册中心定期对服务实例进行健康状态检测，确保可用性；3.服务发现：消费者向注册中心查询可用服务实例列表，并通过负载均衡策略选择调用目标。Consul与Etcd是主流的注册中心工具，均基于分布式键值存储实现服务发现逻辑。Consul内置完善的健康检查机制（支持HTTP、TCP、TTL、Script等方式），并提供DNS查询接口，简化
