不能只靠ModTime()和Size()做同步判断，因NTFS精度仅100ms、NFS/Docker挂载点时间戳不一致、FAT32无纳秒级时间戳，且fs.DirEntry.Info()与os.Stat()结果可能冲突；应统一用os.Stat获取完整元数据，小文件比Size+ModTime，大文件或关键数据须加前64KB+后64KB双端哈希校验，并辅以inode（Linux/macOS）或FileIndexLow（Windows）判同源。
直接用 os.Copy 或基于 ModTime() 的简单比对做跨节点文件同步，90% 的场景会丢文件、反复覆盖或漏同步——这不是性能问题，而是元数据不可靠导致的逻辑错误。
为什么不能只靠 ModTime() 和 Size() 做同步判断
Windows NTFS 的 ModTime() 实际精度只有 100ms，编辑器保存两次可能时间戳完全一样；NFS 挂载点或 Docker volume 中，os.Stat() 和 fs.DirEntry.Info() 返回的时间戳经常不一致；FAT32 根本不存纳秒级时间戳。更危险的是，filepath.WalkDir 回调里拿到的 entry.Info() 可能未加载完整元数据，和后续 os.Stat() 结果冲突。
- 统一用
os.Stat()获取完整元数据，别混用fs.DirEntry.Info() - 小文件可先比
Size()+ModTime()，一致就跳过 - 大文件或关键数据必须加“双端哈希”：读取前 64KB 和后 64KB，用
sha256.Sum256计算，不一致再 fallback 全量校验 - Linux/macOS 补查
syscall.Stat_t.Ino，Windows 查syscall.ByHandleFileInformation.FileIndexLow辅助判同源
如何用 fs.WalkDir 安全遍历并过滤路径
fs.WalkDir 是 Go 1.16+ 推荐方式，但它默认不跳过符号链接循环，也不自动忽略权限错误目录——你得自己控制错误分类和跳过逻辑，否则遇到 Access is denied 就 panic，或在 Windows 上因路径分隔符错配漏过滤 .git。
- 遍历前先
filepath.Clean()输入路径，防../绕过根限制 - 想跳过
.git、node_modules，在回调中检查entry.Type().IsDir() && strings.HasPrefix(entry.Name(), ".")，然后 returnfs.SkipDir - 用
path.Match("*.tmp", entry.Name())过滤临时文件，别用strings.HasSuffix——它不兼容 Windows 路径分隔符 - 遇到
syscall.ENOENT或os.ErrNotExist直接 return nil 继续遍历，别 panic
并发拷贝时怎么稳住内存又不卡吞吐
对 2GB 视频文件调用 io.Copy(io.MultiWriter(hash), f) 会把整个文件读进内存再哈希；手动用 bufio.NewReader(f).Read() 分块又容易因 buffer 复用不当引发 GC 压力；多个 goroutine 同时 os.Create 写同名目标文件，在 Windows 上会报 ERROR_SHARING_VIOLATION。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 用
io.Copy配io.LimitReader(src, size)，而非io.CopyN——前者在文件被截断时返回0, nil，语义更准 - 大文件哈希用
bufio.NewReader+hash.Hash.Write分块读，每次Read后检查err == io.EOF - 目标文件写入前加
os.O_CREATE | os.O_TRUNC，避免 Windows 共享冲突 - 小文件场景下，复用
sync.Pool管理 64KB buffer 可提升约 12% 吞吐，但先用默认 32KB buffer 验证效果
代理层怎么做到故障转移与一致性保障
跨节点同步不是单向搬运，而是多点协同。若某节点宕机或网络中断，代理必须能感知、踢出、重试，且不能破坏最终一致性——比如 A 向 B 同步时失败，B 不应残留半截文件，A 也不该误判已成功。
- 每个同步任务带单调递增版本号（
currentVersion），节点间通过“版本差”拉取增量，而非全量扫描 - 文件以 SHA-256 哈希为唯一 ID，上传即计算并校验，禁止原地修改，只允许追加
- 同步失败时，记录失败哈希 + 版本号到本地
retry.log，启动时自动重试，超 3 次标记为需人工介入 - 用
redsync对关键操作（如版本日志写入）加分布式锁，锁名带节点 ID 和日期，如sync_log:node-01:20260615
真正难的不是并发或哈希，是路径 normalize、错误归类、跨平台行为收敛——尤其是 Windows 的长路径、大小写不敏感、权限模型，会让看似简单的“同步”突然卡在某个 Access is denied 上，这时候得看清楚是 os.Open 还是 os.Stat 报的错。
