必须将倒排索引结构与缓存行为解耦：索引用map[string][]int，缓存只管元信息且惰性校验过期；路径须映射为整数ID，禁用原始路径作key；索引与行偏移必须协同缓存；Range缓存需含fileHash+start+end三要素并校验etag；所有缓存层须响应索引重建信号。
直接用 sync.Map 或 go-cache 做文件索引的本地缓存层，90% 的场景会出问题：内存暴涨、查不到路径、并发读到空数据、TTL 失效、双指针归并结果错乱。真正能撑住几十万文件搜索的，必须把「倒排索引结构」和「缓存行为」解耦——索引本身用 map[string][]int（文档 ID 列表），缓存只管元信息（如行偏移、mtime、etag），且所有缓存操作必须惰性校验过期。
为什么不能把文件路径当 key 存进缓存
有人把 "./data/log_20260618.txt" 直接作为缓存 key 存 []byte 或 struct{ offset int64; size int }，结果 RSS 暴涨、GC 频繁。根本原因不是内存不够，而是路径字符串本身不可控：长度不一、哈希分布差、无法排序，导致后续所有基于范围或前缀的加速逻辑（比如按目录分桶、跳表定位）全部失效。
- 正确做法：所有文件先映射为递增整数 ID（
id := len(docsByID)），路径只存进docsByID []string；缓存 key 统一用fmt.Sprintf("doc:%d", docID) - 路径字符串必须脱离索引主干结构，否则
sort.SearchInts查重失效，双指针归并逻辑崩溃 - 若需按路径前缀快速过滤（如
"./data/"下所有文件），单独建一棵轻量级前缀树（trie.Node），不和倒排索引混用
倒排索引 + 行偏移数组必须一起缓存
只缓存 index["error"] = []int{12, 45, 89} 是没用的——你知道文档 ID，但不知道这些行在磁盘上从哪开始。查词后拿不到物理位置，就只能全量扫描文件，索引彻底失效。
- 构建索引时，必须同步维护
lineOffset []int64：每读一行，调一次file.Seek(0, io.SeekCurrent)记录当前字节偏移 - 缓存这两者时，key 要对齐：
"idx:err"存[]int，"off:12"存int64，避免单 key 存复合结构导致反序列化开销或 GC 压力 - 不要用
time.Now().Unix()标记偏移数组更新时间——容器环境时钟漂移会让缓存长期不刷新；改用runtime.nanotime()+ TTL 微秒偏移
缓存淘汰必须配合 mmap 和 munmap
文件块缓存如果只存内容（[]byte），大文件一缓存就 OOM；如果只存 fd，又没法做精确生命周期管理。真正的高性能方案是：缓存元信息 + mmap 映射 + 淘汰时 munmap。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 一级缓存用
bigcache，value 只存struct{ fd uintptr; offset int64; length int; expireAt int64 }，禁止存原始数据 -
bigcache.NewBigCache()必须传OnRemove回调，在淘汰时调syscall.Munmap（Linux）或VirtualFree（Windows）释放虚拟内存 - 命中后不拷贝数据，返回
unsafe.Pointer+length，由上层用slice切片访问；但必须确保该 mmap 区域未被munmap—— 所以淘汰逻辑和访问逻辑要严格串行或加引用计数
HTTP Range 缓存必须拆分 key 并校验 etag
用户请求 Range: bytes=100-199，你却用整个文件的 etag 当作缓存 key，会导致不同 range 请求互相覆盖，或者永远无法命中。
- Range 缓存 key 必须含三要素：
fileHash+start+end，例如fmt.Sprintf("range:%s:%d:%d", hash, 100, 199) - 每个 range 块旁必须存一个同名
.meta文件，记录size、mtime、etag，不依赖os.Stat；否则并发 stat 可能返回陈旧 mtime - 每次
Load必须检查etag是否匹配源文件，不匹配则丢弃并重新生成——不能只靠 TTL，因为文件可能被外部进程修改
最易被忽略的一点：所有缓存层都必须接受「索引重建」信号。当文件系统发生批量变更（如日志轮转、配置热更），不能只清空缓存，还要触发 lineOffset 重算和 docsByID 重载——否则倒排索引和物理偏移彻底脱节，查出来的行全是错的。
