-
http.ServeFile可快速提供静态文件下载，但存在路径遍历风险，需用filepath.Clean校验并限制在允许目录内；不支持断点续传；强制下载需设Content-Disposition为attachment，中文名需URL编码；大文件应io.Copy流式传输并处理连接中断。
-
Consul客户端初始化不检测连接，err为nil仅表示配置解析成功；真实连接失败发生在kv.Get等首次业务调用时，需对首条调用判err且用client.Status().Leader().Do(ctx)探测，超时应设为3秒。
-
在Go中捕获网络请求异常需显式传递error、结构化记录上下文、避免panic泄露，并封装可复用请求逻辑；须双重检查resp和err，defer/recover仅用于顶层handler，按错误类型分级日志（ERROR/WARN/INFO）。
-
模块下载失败应先检查GOPROXY和GOSUMDB配置，国内常见错误为GOPROXY设为不可达的proxy.golang.org或GOSUMDB未关闭导致校验失败；可临时设为goenv-wGOPROXY=https://goproxy.cn,direct和goenv-wGOSUMDB=off。
-
context.WithTimeout是Go并发中超时控制最可靠的方式，它提供可取消、可传递、可组合的语义，需在每次阻塞操作前检查ctx.Err()并传入下游函数。
-
本文介绍一种无需第三方库的轻量方案，通过封装http.HandleFunc实现请求路径的自动匹配校验，避免手动重复比对req.URL.Path，提升路由处理逻辑的可读性、模块化与DRY性。
-
slice元素地址扩容后失效，因底层数组被替换导致原指针指向已释放内存，引发panic或脏数据；安全做法是用索引替代指针，禁用跨goroutine共享元素指针。
-
推荐用iota定义方向或按键枚举：方向支持4/8向及组合，按键封装避免魔法数字；需实现String()提升调试体验，并注意起始值、跳号、跨包复用和类型安全比较。
-
range遍历切片时修改元素值不生效，因默认拷贝值而非引用；需通过索引赋值如s[i]=newValue；遍历map顺序随机，非bug，需排序key再遍历；channel上range会阻塞至关闭。
-
结论：传指针或传值不影响benchmark框架开销，但显著影响被测函数性能；大结构体传值会复制，传指针仅传8字节地址，应确保被测函数实际操作数据以真实反映差异。
-
应通过两次heap快照差分分析alloc_space增量来识别内存泄漏，而非仅看单次inuse_space；配合强制GC、稳定压测、goroutine数监控及goleak自动检测，可精准定位泄漏点。
-
因为channel默认无缓冲，发送和接收必须同步配对；若只发送不接收或只接收不发送，goroutine将在操作处永久阻塞。
-
reflect.Call返回的[]reflect.Value必须先检查IsValid()再取值，基本类型用.Int()等方法，结构体/指针优先用.Interface()转回原类型，error需先判Kind()==reflect.Interface且非nil；返回值天然不可寻址，不可调.Addr()，需先.Interface()再取地址；高频场景应缓存reflect.Value并避免重复反射调用。
-
TCP三次握手仅含SYN_SENT、SYN_RECEIVED、ESTABLISHED三个核心状态，应使用具名结构体+指针接收者方法实现，避免过早抽象State接口；状态转移须强序、排他、不可逆，配合uint8枚举与switch控制，每个状态只响应特定报文，并内嵌timer管理超时重传。
-
应执行gomodtidy自动合并重复require并选择最小可行版本，而非手动删除；若存在版本冲突，需通过gomodgraph定位源头、检查CHANGELOG或使用replace临时锁定版本。
