sync.Map仅提供并发安全的内存映射，缺乏淘汰策略、文件变更感知、跨进程共享及fallback机制，无法构成真正多级缓存；它不支持分块加载、不处理符号链接与元信息变更，服务重启或文件外部修改后即产生脏数据。
直接用 sync.Map 做单层内存缓存，解决不了大文件、冷热不均、跨进程失效等实际问题；真正支持多级缓存的文件读取优化器，必须把内存、本地磁盘、甚至远程一致性校验串起来，否则只是“伪多级”。
为什么不能只靠 sync.Map 做多级缓存
很多人误以为给 sync.Map 加个 TTL 就是多级缓存——其实它只是并发安全的内存映射，连“一级缓存”都算不上完整：没淘汰策略、不感知文件变更、不处理路径符号链接、无法跨进程共享。一旦服务重启或文件被外部修改，sync.Map 里存的全是脏数据。
- 文件内容更新后，
sync.Map不会自动失效（除非你手动监听 inotify 或轮询os.Stat） - 大文件（>100MB）全量缓存进内存，容易触发 GC 或 OOM，而
sync.Map本身不支持分块或按需加载 - 多个实例（如 Docker 多副本）各自维护一份
sync.Map，缓存完全隔离，无法协同 - 没有 fallback 机制：内存 miss 后，它不会自动查磁盘缓存或回源，而是直接调
os.ReadFile
io.Copy 和 bufio.NewReaderSize 在多级缓存路径中的分工
多级缓存不是“一层套一层”，而是按访问模式分流：热路径走内存，温路径走本地 SSD 缓存文件，冷路径才穿透到原始文件。这时 I/O 工具链要明确分工：
- 内存层（L1）：用
sync.Map存小文件（filepath.Clean(filename) +mtimehash，避免软链接歧义 - 磁盘层（L2）：用
io.Copy把原始文件内容 dump 到/tmp/.filecache/xxx.hash，不走bufio—— 因为 L2 本质是持久化快照，不需要缓冲解析 - 流式读取层（L3）：对大文件，跳过 L1/L2，直接用
bufio.NewReaderSize(f, 256*1024)配合sync.Pool复用 buffer，避免每次 malloc
关键点：io.Copy 适合做“拷贝即缓存”，bufio.NewReaderSize 适合做“边读边用”，两者不能混用在同一级。
立即学习“go语言免费学习笔记（深入）”；
如何让磁盘缓存（L2）真正生效且不污染 /tmp
本地磁盘缓存最容易踩的坑是路径混乱和权限泄漏。直接写 /tmp 看似简单，但会导致：
- 不同用户运行的服务写入同一路径，权限冲突（
permission denied） - 容器环境里
/tmp被挂载为 tmpfs，缓存一重启就丢，失去 L2 意义 - 没清理机制，缓存文件堆积占满磁盘
正确做法：
- 缓存根目录设为
$XDG_CACHE_HOME/filecache（Linux/macOS）或%LocalAppData%\filecache（Windows），由环境变量驱动 - 每个缓存文件名用
sha256(filepath + mtime.String()).Hex()[0:16]，避免路径长度超限或特殊字符 - 写入前用
os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_EXCL, 0600)，确保原子写入；失败则 fallback 到 L3 流式读 - 启动时用
filepath.WalkDir扫描过期缓存（mtime 超过 7 天），但只 unlink，不递归删除目录——防止误删其他进程缓存
文件变更检测必须绕过 os.Stat 轮询
多级缓存最脆弱的一环是“怎么知道文件变了”。用 time.Now().Sub(fi.ModTime()) > ttl 判断，看似合理，实则错在：文件可能被 touch -m 修改时间但内容未变，也可能内容变了但 mtime 被刻意锁定（如某些备份工具）。
- Linux 上优先用
inotify（通过golang.org/x/sys/unix调用inotify_add_watch），监听IN_MODIFY | IN_MOVED_TO，事件到达即清对应 key - macOS 用
FSEvents（需 cgo 或github.com/fsnotify/fsnotify底层封装），注意它不报告文件内容变化，只报路径事件 - Windows 用
ReadDirectoryChangesW，但要注意递归监听开销大，建议只监本级目录 - 兜底方案：对无 inotify 的环境（如容器无权限），改用
sha256(filedata[:min(8192, len(data))])前 8KB 哈希 + mtime 组合判断，比纯 mtime 可靠得多
别忘了：符号链接目标变更、硬链接计数变化、ACL 权限调整，这些都不会触发 mtime 更新，但会影响读取结果——多级缓存必须把这些元信息也纳入校验维度，否则“缓存命中”等于“静默错误”。
