Go标准库不支持文件自动过期，需应用层实现：写入时嵌入时间戳、配对存元数据文件或统一管理过期索引，并配合定时扫描+os.Stat校验+安全删除。
Go 语言标准库不提供「文件写入时自带过期时间」的能力——文件系统本身没有 TTL（time-to-live）语义，os.WriteFile 或 os.Create 写出的文件不会自动删除或失效。所谓“带过期时间的文件缓存”，必须由应用层主动实现策略控制。
为什么不能直接给文件设过期时间
文件是持久化存储单元，操作系统不跟踪业务语义；即使你用 os.Chtimes 修改 mtime 或 atime，也不会触发自动清理。所有“过期”行为都得靠程序自己判断和执行。
- 常见错误现象：
os.WriteFile("cache.json", data, 0644)后以为加个注释“有效期5分钟”就真能自动删——实际不会 - 真实依赖场景：临时配置快照、API 响应缓存、生成的 token 文件、本地 mock 数据等
- 关键区别：这不是 Redis 的
SET key value EX 300，而是你要自己记时间、自己删文件
手动实现文件过期的三种可行方式
核心思路只有两个：记录时间戳 + 定期/按需清理。没有银弹，只有取舍。
-
写入时嵌入时间戳：把过期时间序列化进文件内容本身（如 JSON 中加
"expires_at": 1748993880），每次读取前解析并校验；适合小文件、结构化数据 -
配对存储元数据文件：写
data.bin同时写data.bin.meta，后者只存expires_at时间戳；读取时先读 meta，再决定是否加载主文件 -
统一管理过期索引：维护一个内存 map 或 SQLite 表，记录
filepath → expires_at，启动时扫描过期项并os.Remove；适合高频写入、大量缓存文件的场景
go-cache / cache2go 不适用于文件缓存
这两个库是纯内存缓存，cache2go.Cache() 存的是 Go 对象，不是磁盘文件；它们的 Add(key, value, ttl) 机制完全不涉及 os.Open 或路径操作。误用会导致：
立即学习“go语言免费学习笔记（深入）”；
- 你以为缓存了文件路径字符串，实际只是缓存了一个 string，和原文件生命周期完全无关
- 文件被外部进程修改或删除后，缓存里的路径字符串依然“有效”，但
os.Stat会报No such file - 内存缓存过期 ≠ 文件被删；你仍需额外逻辑调用
os.Remove
真正安全的文件缓存清理实践
不要依赖单次写入动作完成全部逻辑。生产环境必须拆解为可验证、可重试、可观测的步骤：
- 写入文件后，立刻用
os.Chtimes(path, atime, mtime)把mtime设为期望的过期时间点（便于后续find -mmin +5批量清理） - 启动时或定时任务中，用
filepath.WalkDir扫描目录，对每个文件调用os.Stat检查ModTime().After(time.Now())是否已过期 - 删除前加日志：
log.Printf("removing expired cache file: %s", path)；失败时记录 error 但不停止后续清理 - 若需原子性，先
os.Rename到临时目录再os.RemoveAll，避免清理中断导致残留
最易被忽略的一点：文件权限可能阻止删除（尤其在容器或 CI 环境中），os.Remove 失败不等于“文件没过期”，而可能是 permission denied —— 必须检查 error 类型，而不是只看 nil。
