-
用URL路径做版本区分最稳妥，即/v1/users、/v2/users；需为各版本建独立RouterGroup，handler命名带版本后缀，响应构造器按版本分离，共用中间件挂根路由，路由注册须先Group再子路由，v1下线应返回410或301并监控调用量。
-
加密算法需要性能优化因为其涉及大量数学和位操作，在高并发场景下易成瓶颈，Golang标准库虽已优化，但特定场景下手写汇编仍可显著提速。1.加密运算密集导致性能瓶颈；2.标准库实现注重可读性和跨平台，非最优效率；3.汇编优化适用于频繁调用、有对应底层指令、固定目标平台的场景；4.优化步骤包括定位热点函数、编写汇编替代实现、构建标签控制启用平台、Benchmark对比效果；5.实际案例中AES在支持AES-NI的CPU上汇编优化可提速2~3倍。
-
Go测试文件必须命名为xxx_test.go且与被测组件同目录同包；测试函数须为funcTestXxx(t*testing.T)，首字母大写，否则gotest将忽略。
-
策略接口应只定义纯行为契约，共享依赖通过构造函数注入；避免空实现、全局变量并发写、硬编码路由及nil指针调用，推荐注册表+工厂函数+读写锁保障安全。
-
Go中重构包需保持导出一致性、依赖方向清晰和API稳定性；拆分应解决职责混杂问题，合并须统一版本与错误类型，辅以gorename等工具验证依赖流向。
-
Go默认不压缩HTTP响应，必须显式启用；gzip.Handler需置于最外层以完整接管Write/WriteHeader，否则响应体未压缩而头已设Content-Encoding导致浏览器解压失败。
-
GEOADD参数顺序错误、坐标系不匹配、GeoRadius单位误用是三大高频事故源；必须严格遵循lng,lat顺序、WGS84坐标系、小写单位（m/km/ft/mi），并端到端验证。
-
SetMaxOpenConns应设为数据库max_connections的60%～80%，兼顾QPS、平均耗时与余量，并配合SetMaxIdleConns（1/2～1/3）、SetConnMaxLifetime（10～30分钟）和SetConnMaxIdleTime（5～10分钟）协同调优。
-
Go语言中真正支持格式化输出的是fmt.Printf、fmt.Sprintf和fmt.Fprintf；fmt.Print/Println仅原样拼接参数，不解析%动词，故无法格式化。
-
在CI/CD中使用GoModules需提交go.mod和go.sum以锁定依赖版本，设置GOPROXY提升下载速度，配置GOPRIVATE处理私有模块，结合GitHubActions示例实现构建、测试自动化，确保依赖一致与构建可重复。
-
使用testify/assert库可提升Go测试代码的可读性和效率，通过gogetgithub.com/stretchr/testify/assert安装后，导入assert包并使用如assert.Equal、assert.True等函数进行断言，相比手动if判断更简洁清晰。
-
因为net.Listen("tcp",addr)不支持SO_REUSEPORT，无法让多进程共享同一端口；单进程内靠goroutine轮询仍是单点accept，无法实现内核级连接分发与多核负载均衡。
-
Golang通过多返回值和显式错误检查确保错误不被忽略，要求调用方主动处理错误，提升程序健壮性；使用error包装、自定义错误类型及errors.Is/As进行精确判断，避免忽略、重复记录或滥用panic，实现清晰可靠的错误处理。
-
交叉编译Go需显式设置GOOS和GOARCH，禁用CGO以保证静态链接，推荐gox或goreleaser自动化多平台构建，并注意路径分隔符与//go:embed路径规范。
-
不能直接用map[string]struct{}做并发安全的Set，因为Go原生map非并发安全，多goroutine读写会panic；须用sync.RWMutex封装，且mutex必须作为结构体字段嵌入并置于map前，初始化需make，Add/Contains/Delete要正确加锁，nilmap需防护，sync.Map不适合Set场景。
