-
必须配置GOPRIVATE环境变量，否则Go工具链将私有模块误作公开模块经proxy访问而失败；还需配合Git认证配置和GOSUMDB=off或+insecure以解决拉取、校验及CI/CD问题。
-
内网无法访问proxy.golang.org时应禁用代理并部署离线方案：执行goenv-wGOPROXY=direct临时绕过，推荐部署athens或goproxy.cn离线镜像，并同步设置GOSUMDB=off或内网校验服务。
-
微信签名验证需手动排序拼接并SHA1，XML解析须处理CDATA和字段类型，access_token需缓存、预刷新与串行更新，code须5分钟内单次使用并幂等处理。
-
runtime.GC()不该被频繁调用，因其破坏Go自适应GC节奏、激增STW次数、干扰内存学习；应优先调优GOGC、复用对象、预分配切片，并通过业务指标验证优化效果。
-
Go服务需手动监听SIGINT/SIGTERM并调用http.Server.Shutdown()配合带超时的context，否则进程猝死导致请求中断、日志截断、事务不完整；Shutdown()须用WithTimeout上下文，忽略ErrServerClosed，后台goroutine须统一监听ctx.Done()退出。
-
Example函数必须以大写Example开头、无参数无返回值，定义在同包的_test.go文件中，末尾用顶格//Output:断言fmt.Println输出，且需显式初始化依赖。
-
应使用统一响应结构体封装WriteJSON函数：Code严格对应HTTP状态码，Message为用户提示，Data仅承载业务数据，Pagination仅列表接口使用，BizCode区分业务码；错误路径也返回同结构体，避免混用状态码与业务码。
-
sync.Map不是普通map的并发安全替代品，而是专为读多写少、键生命周期不一场景设计的最终一致性结构，不支持forrange、无len()、非原子遍历，性能在高并发读时优但频繁写时更差。
-
本文介绍如何在Go语言中高效实现“单客户端单连接”约束，即当用户在新标签页打开页面时自动关闭其旧WebSocket连接，核心方案是使用带互斥锁的session-ID映射表，兼顾正确性与性能。
-
Go1.16+中应使用os.ReadDir替代已弃用的io/ioutil.ReadDir；os.ReadDir返回轻量级fs.DirEntry，支持Name()、IsDir()等方法，需Info()获取完整文件信息；嵌套目录遍历推荐filepath.WalkDir。
-
健康检查接口必须暴露/health且返回200，需同步探测数据库、Redis、下游HTTP等关键依赖并设超时，/health与/ready必须分离，同时通过Prometheus暴露多维健康指标。
-
实现Golang文件断点续传需利用HTTP的Range请求头与本地文件偏移写入。首先通过net/http发送带Range头的GET请求获取部分数据，服务端返回206状态码表示支持。使用os.OpenFile结合Seek从指定偏移写入文件，避免覆盖。为恢复任务，需持久化记录下载进度（如JSON文件），包含URL、总大小、已下载字节等信息，重启时读取并续传。完成后再删除元数据文件。可选优化：通过HEAD请求获总大小，分块并发下载多个Range至临时文件，最后按序合并提升速度。
-
Go调度器通过Work-Stealing实现负载均衡：当P本地队列为空且全局队列、netpoll均无任务时，按伪随机顺序最多尝试4轮窃取，每次从目标P队列尾部偷取一半（≤256个）G，依赖原子操作保障无锁安全。
-
最稳妥方式是直接用s3.PutObject，v2SDK已封装认证与重试；大文件用s3manager.Uploader，小文件用PutObject；注意region、bucket、key严格匹配及权限配置。
-
math包函数高并发变慢主因是未向量化且goroutine调度放大调用开销；累加浮点数需防精度丢失，推荐Kahan求和或math.FMA；避免float64等值判断。
