最稳组合是robfig/cron/v3调度+os.readdir遍历+entry.info().modtime()提取时间；硬解析路径名、裸用filepath.walk、跨设备用os.rename易静默失败。
直接说结论：用 robfig/cron/v3 调度 + os.ReadDir 遍历 + entry.Info().ModTime() 提取时间，是当前最稳的组合；硬解析路径名、裸用 filepath.Walk、跨设备用 os.Rename，这三类操作最容易静默失败。
为什么不用 filepath.Walk 做归档
它不保证遍历顺序，遇到符号链接时行为不透明，更关键的是：归档常需“先判断是否为叶子目录”或“跳过 .git”，而 filepath.Walk 无法在进入前过滤。你看到的“目录被跳过”或“同一目录处理两次”，大概率是它在 symlink 上绕圈或并发干扰导致的。
- 改用
os.ReadDir（Go 1.16+），返回有序fs.DirEntry列表，可显式调用entry.IsDir()和entry.Name()做前置判断 - 要跳过隐藏项？
entry.Name()[0] == '.'就够了，不用额外os.Stat - Go 版本低于 1.16？降级用
os.Open+Readdir，但必须补一句fi.Mode().IsDir()才能区分目录和文件
归档时怎么安全提取日期
别从文件名里硬抠 2024-03-15——命名不规范就崩，且违背真实意图（你真正想归档的是“修改于今天”的文件，不是“名字含今天”的文件）。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 一律用
entry.Info().ModTime()，它已由os.ReadDir预加载，复用即可，避免重复os.Stat - 时区敏感：本地时区归档用默认值；若需统一 UTC，加
t.In(time.UTC)再格式化 - 格式化示例：
t.Format("2006/01/02")得到2026/06/10，直接拼进目标路径
跨文件系统移动文件会静默失败
os.Rename 在跨设备（比如 /home 和 /mnt/nas 不在同一挂载点）时直接报 invalid cross-device link，但错误信息不提示“是跨设备”，只告诉你失败，容易卡在日志里找不到原因。
- 归档前先用
os.SameFile检查源和目标是否同设备 - 跨设备时改用
io.Copy+os.RemoveAll组合：先复制，再删源，最后校验大小 - 目标路径写入前务必
os.MkdirAll并检查权限，否则io.Copy会因无写权限直接 panic
定时任务别裸用 time.Ticker
它没有崩溃恢复、去重、分布式协调能力。进程一挂，当天归档就丢；重启两次，可能触发双删——尤其清理类任务，幂等性比准时更重要。
- 生产环境优先选
robfig/cron/v3，配cron.WithLocation(time.UTC)避免时区漂移 - 加
cron.DelayIfStillRunning链，防上次归档卡住时新任务又进来 - 归档 SQL 或文件操作，必须带 context timeout，例如
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute) - 如果是多实例部署，归档前用 Redis
SET lock:archive NX EX 300抢锁，不然DELETE FROM logs WHERE ...可能被两个节点同时执行
真正的难点不在调度或移动，而在“判断该不该动”——比如一个文件刚被编辑一半，ModTime 已更新，但内容不完整；又比如某归档目录里混着用户手动创建的子目录，自动清理会误伤。这类边界情况没法靠工具自动兜底，得靠配置里的白名单或排除规则来守门。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
