-
Go中无标准BM25库，需手写核心逻辑：预计算IDF、传入k1/b参数、确保分词后为token数而非字符数，并统一预处理（小写、去停用词、词干化等）以对齐Elasticsearch结果。
-
bufio.Scanner读整行最稳：它按行切分、自动丢换行符、内置缓冲、可处理大文本；需先调Scan()再取Text()，错误用Err()检查，默认单行上限64KB。
-
gRPCServer默认无连接数限制，实际受限于操作系统和Go运行时；需通过KeepaliveParams管理连接生命周期，并用拦截器+令牌桶限流控制并发请求。
-
“cannotdeterminemodulepath”错误是因为Go无法推断合法模块路径，需显式执行gomodinitgithub.com/user/repo（不能省略路径），且项目不能位于$GOPATH/src内。
-
推荐使用流式读写处理大文件，通过bufio缓冲分块读取避免内存溢出，按行处理可用Scanner，大块读取用固定buffer，随机访问可选mmap，注意缓冲区大小、资源释放与对象复用，结合场景平衡性能与内存。
-
应选用golang.org/x/time/rate的rate.Limiter——基于令牌桶、线程安全、经高并发验证；避免手写实现，注意burst与r的语义、按用户隔离实例、用Wait而非Allow、配合Header返回限速状态、不跨节点共享、SetLimitAndBurst支持运行时调整。
-
Go包管理核心在于统一行为约束：go.mod和go.sum必须提交，变更须经goget/tidy/edit；私有模块需配置GOPRIVATE；vendor是否提交取决于CI构建方式，且必须校验一致性。
-
最稳妥的做法是用Viper按优先级合并多源配置并原生支持多环境切分，通过命名规范（如config.dev.yaml）、SetConfigName/AddConfigPath、环境变量或命令行控制加载，显式声明mapstructuretag，禁用生产环境WatchConfig，并启动时打印生效配置。
-
选用高效序列化协议如Protobuf或MessagePack替代Gob，精简传输字段，复用缓冲区降低GC压力，并按需启用压缩，可显著提升GoRPC性能。
-
Homebrew默认安装的Go版本滞后于官网最新稳定版，因其版本发布需审核测试；正确安装指定版本需添加standardnotes/go-versionstap后执行brewinstallgo@x.x；多版本共存时须清理GOROOT硬编码、确保Homebrewbin在PATH前端，并用direnv实现项目级自动切换。
-
Go不提供开箱即用负载均衡，因http.DefaultClient和grpc.Dial传入多地址仍只连首个；需自定义RoundTripper用原子索引轮询、克隆请求并设完整URL，健康检查须独立goroutine定时执行。
-
最快上手但有坑：json.Marshal/Unmarshal仅处理导出字段，time.Time转字符串，func/chan/unsafe.Pointer等静默丢弃或panic；适用纯数据DTO；copier更智能但不处理接口；自定义Clone最可控；gob保留未导出字段但需注册且类型严格一致。
-
在Go程序中忽略特定错误时，需使用errors.Is判断错误是否为预定义值，或用errors.As转换为具体类型。例如：1.errors.Is用于检查错误是否等于os.ErrNotExist等固定值；2.errors.As用于提取结构体错误类型的字段或方法，需传入指针类型；3.应避免直接比较错误字符串，自定义错误时需导出指针类型以便外部调用者使用。
-
reflect.DeepEqual因逐字段递归比较且不支持func/map（含不可比key）、指针地址敏感、time.Time时区/纳秒差异、map遍历无序、nil与空切片区分、忽略自定义Equal方法等，常误判相等。
-
Go结构体字段顺序直接影响内存占用，因编译器按对齐规则插入padding；应按unsafe.Alignof值分组排列（如8字节对齐组前置），而非简单按类型大小排序，并注意JSON、Cgo、缓存行等约束。
