不能只靠os.stat()+modtime()判断文件同步，因ntfs精度仅100ms、nfs/docker挂载点时间截断滞后、fat32无纳秒支持，且os.readdir().info()与os.stat()返回的modtime可能不一致；应统一用os.stat()获取完整元数据，结合size、mode、inode/fileindexlow及分块哈希做强校验。
为什么不能只靠 os.Stat() + ModTime() 判断文件是否需要同步
因为时间戳在多数文件系统上不可靠：NTFS 实际精度只有 100ms，编辑器连续保存可能触发多次写入但 ModTime() 不变；NFS 和 Docker volume 挂载点常返回截断或滞后的修改时间；FAT32 根本不存纳秒级时间戳。更危险的是，os.ReadDir() 返回的 fs.DirEntry.Info() 和单独调用 os.Stat() 在同一路径上可能给出不同 ModTime() ——前者不保证加载完整元数据。
实操建议：
- 统一用
os.Stat()获取完整元数据，避免混用os.ReadDir()和os.Stat() - 小文件可组合
Size()和ModTime()判定跳过；大文件或关键数据必须加双端哈希（前 64KB + 后 64KB 的sha256.Sum256），不一致再 fallback 全量校验 - Linux/macOS 补查
syscall.Stat_t.Ino，Windows 查syscall.ByHandleFileInformation.FileIndexLow，作为强去重依据
filepath.WalkDir 遍历时如何安全过滤与防崩
默认行为既不跳过符号链接循环，也不自动忽略权限错误目录——遇到 Access is denied 就 panic 是常见错误；用 strings.HasPrefix(filepath.Base(path), ".") 过滤隐藏文件，在 Windows 上会因路径分隔符差异导致匹配失败。
实操建议：
- 用
path.Match("*.tmp", entry.Name())替代strings.HasSuffix，兼容跨平台通配 - 遇到
syscall.ENOENT、os.ErrNotExist直接return nil，继续遍历 - 想跳过
.git、node_modules，在回调中检查entry.Type().IsDir() && strings.HasPrefix(entry.Name(), ".")，然后return fs.SkipDir - 遍历前先
filepath.Clean()输入路径，防止../绕过根目录限制
并发拷贝时怎么避免内存爆掉又不牺牲吞吐
对 2GB 视频文件调用 io.Copy(io.MultiWriter(hash), f) 会把整个文件读进内存再哈希；手动分块用 bufio.NewReader(f).Read() 又容易因 buffer 复用不当引发 GC 压力；多个 goroutine 同时 os.Create 写同名目标文件，Windows 会报 ERROR_SHARING_VIOLATION，Linux 虽不报错但旧进程仍持有句柄。
实操建议：
- 哈希计算用固定大小 buffer（如 64KB）分块读取，显式复用
make([]byte, 65536)，避免高频分配 - 目标文件写入前加
os.O_EXCL标志，防止竞态覆盖；Windows 下需额外处理共享模式（syscall.FILE_SHARE_READ） - 限制并发数（如
sem := make(chan struct{}, 8)），每 goroutine 执行前sem ，结束后 <code> - 大文件优先尝试硬链接（
os.Link()），失败再走拷贝流程——注意硬链接仅限同文件系统
属性同步为何不能直接用 os.Chmod + os.Chown
这两个函数只修改目标路径的权限和所有者，但实际同步中陷阱极多：os.Chown 在非 root 用户（Linux/macOS）或任意 Windows 用户下必然返回 operation not permitted；Windows NTFS 支持 ACL，os.Chmod 只能设基础权限位，对 WRITE_DAC 等完全无感；若源是符号链接，os.Lstat 读的是链接本身元数据，但 os.Chmod(dst, fi.Mode()) 默认作用于链接指向的文件。
实操建议：
- 先用
os.Lstat读源路径，检查fi.Mode() & os.ModeSymlink != 0；若是软链接，用os.Readlink读目标，再用os.Symlink创建 - 权限同步：Linux/macOS 用
os.Chmod，Windows 跳过（或用golang.org/x/sys/windows调用SetFileSecurity） - 所有者同步：仅当运行用户为 root 且目标支持时才调用
os.Chown；否则记录 warn 日志并继续 - 扩展属性（xattrs）：Linux 用
github.com/pkg/xattr，读取后逐项xattr.Set；macOS 和 Windows 应提前检测并跳过
真正可靠的同步不是“快”，而是“准跳”——跳过所有不必处理的文件，且不依赖模糊元信息。Windows 上尤其要禁用 ModTime() 比较，默认改用 Size() + 双端 SHA256；ACL 同步必须以管理员权限调用 windows.GetNamedSecurityInfo，否则静默失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
