-
中介者模式通过接口与组合实现模块间松耦合通信，各模块仅注册事件处理器到中介者，由中介者统一调度消息分发；同步调用直接执行回调，异步则通过channel传递事件，避免循环依赖且提升可维护性。
-
goclean-modcache只删除$GOPATH/pkg/mod（或GOPROXY未设时的$HOME/go/pkg/mod）下的所有已下载模块、校验和文件（sum.db）、解压源码及zip缓存，不触碰项目内的go.mod、go.sum或vendor/目录。
-
pprof默认仅注册路由不启动服务，需显式调用http.ListenAndServe或手动挂载到自定义ServeMux；CPU采样需足够时长（20–30秒）并避开启动噪音，注意内联影响及flat/sum区分，线上可安全使用但应避免图形界面持续拉取。
-
errors.As用于在错误链中查找并提取指定类型的错误实例。它能穿透多层包装，沿错误链调用Unwrap方法，找到匹配目标类型的错误并赋值给变量，适用于需获取自定义错误结构体信息的场景。与errors.Is（比较错误值）不同，errors.As关注错误类型和数据提取。相比仅对最外层生效的类型断言，errors.As更健壮，是处理包装错误的标准方式。
-
Go并发下载需用goroutine处理任务、channel协调状态，并通过带缓冲channel（如sem:=make(chanstruct{},5)）实现并发控制，配合WaitGroup确保worker启动完成后再关闭输入channel。
-
main.go应放在cmd/myapp/目录下，仅负责加载配置、初始化依赖、调用app.Run()；internal/是编译期私有隔离区，存放高内聚领域实现；pkg/仅放有稳定契约、可被外部复用的模块。
-
必须同时用reflect.TypeOf和reflect.ValueOf——前者获取字段名、类型、标签，后者获取实际值；只用其一会panic或返回空。
-
Go游戏服务器需用net/tcp+goroutine管理万级连接，设读写超时、bufio处理粘包与缓冲写、sync.Once防重复清理、消息推chan由独立goroutine消费；WebSocket须设SetPongHandler并主动ping；玩家状态用map+RWMutex分桶更优；协议解析须限制单次读取长度。
-
Gorpc.Client默认不支持超时，需用context.WithTimeout+select封装实现；或改用jsonrpc配合http.Transport超时配置；生产环境推荐迁移到gRPC或go-kit等成熟框架。
-
Go支持任意层级指针，**T用于修改指针变量本身（如函数内改变调用方的*T指向）或Cgo交互等不可替代场景；但需警惕nil解引用panic、初始化陷阱及可读性下降，多数情况应优先选用结构体、切片或接口。
-
io.CopyN是按固定字节切分大文件最稳妥的方式，避免内存爆炸；需零填充命名分片、顺序合并并用SHA256校验完整性。
-
基准测试需显式启用采样：用-cpuprofile=cpu.pprof或-memprofile=mem.pprof，配合-benchmem和-gcflags="-l"禁用内联；确保Benchmark函数含循环工作量、不手动触发GC，并在干净环境运行以保障pprof数据有效。
-
当Go程序对TCP连接调用conn.File()获取底层文件描述符（FD）后，该FD会被设为阻塞模式，导致后续conn.Close()失效——操作系统层面连接仍处于ESTABLISHED状态，根本原因是阻塞I/O无法被并发close中断。
-
forrange遍历时修改v无效，因v是副本；须用索引s[i]=新值。跳多层循环需标签break：标签紧贴for前、带冒号、不跨代码块。
-
Go二进制默认静态链接、零外部依赖，但需警惕隐性环境依赖：cgo启用、外部命令调用、硬编码系统路径、TLS证书查找、DNS解析及嵌入资源管理。
