Go文件同步工具应基于fsnotify跨平台监听，结合单向主从策略、原子写入、延迟删除及配置化CLI；需过滤临时文件、处理符号链接、大文件空间检查与优雅退出。

用 Go 开发一个轻量、可靠、跨平台的文件同步工具，核心在于实时监控目录变化，并按需同步文件。关键不在于重造 rsync，而是在于用好 fsnotify 监控 + 明确的同步策略 + 安全的文件操作。

使用 fsnotify 实现跨平台目录监听

Go 本身不提供原生文件系统事件 API，fsnotify 是事实标准库（github.com/fsnotify/fsnotify）。它封装了 inotify（Linux）、kqueue（macOS）、ReadDirectoryChangesW（Windows）等底层机制，对用户透明。

监听时注意以下几点：

• 递归监听需手动遍历子目录并为每个路径调用 watcher.Add()；Go 1.19+ 的 fsnotify.Watcher.Add 不自动递归
• 关注 fsnotify.Write（含创建/修改）、Create、Remove、Rename 事件；Chmod 通常可忽略，除非需同步权限
• 事件可能重复或合并（尤其 macOS），建议加简单去重：用文件路径 + 事件类型 + 时间戳（精度到毫秒）做临时缓存，100ms 内相同事件丢弃
• 务必处理 watcher.Errors channel，否则 goroutine 可能永久阻塞

设计健壮的同步逻辑：避免竞态与覆盖

监听到变更后，不能直接“复制过去”，要判断是否真需同步。典型策略如下：

openclaw-gitcode-pr-monitor

监控一个或多个 GitCode 仓库的 PR，通过 OpenClaw Gateway 自动执行 AI 审查，发布 PR 评论，并发送钉钉和企业微信通知。

下载

立即学习“go语言免费学习笔记（深入）”；

• 单向主从同步：只允许 source → target。对 Create/Write/Rename 事件，在 target 检查源文件是否存在、大小/ModTime 是否更新；仅当 source 更“新”（按 ModTime 或校验和）才覆盖
• 跳过临时文件：过滤以 .、~、.tmp、.swp 结尾的文件，或匹配编辑器常见临时名（如 *.un~）
• 原子写入保障：用 os.Rename 替代 os.Copy（若在同一磁盘）；跨磁盘则先 CopyFile 到临时名（如 file.new），再 Rename 覆盖，防止同步中断导致损坏
• 删除需谨慎：收到 Remove 事件，不立即删 target；可设“延迟删除队列”，等待 2 秒无对应 Create，再执行（防编辑器先删后写）

支持配置化与基础 CLI 交互

工具应可通过命令行指定 source/target 目录、忽略规则、是否递归等。推荐用 spf13/pflag（flag 增强版）解析参数：

• -source /path/to/src 和 -target /path/to/dst 必填
• -ignore "node_modules,.git,*.log" 支持逗号分隔 glob 模式，用 filepath.Match 或 doublestar.Glob 匹配
• -once 模式：扫描一次并同步差异后退出（适合定时任务）；默认为长运行监听模式
• 日志用 log/slog（Go 1.21+），级别设为 Info 或 Debug，输出事件类型、文件路径、操作结果

补充实用细节提升稳定性

真实场景中容易忽略但影响体验的点：

• 符号链接处理：默认跳过 symlink（os.Lstat 判断），避免意外同步到系统目录；加 -follow-symlinks 开关可选启用
• 大文件保护：对 >100MB 的文件，同步前检查 target 磁盘剩余空间（unix.Statfs 或 golang.org/x/sys/unix）
• 优雅退出：监听 os.Interrupt（Ctrl+C）和 syscall.SIGTERM，关闭 watcher 并等待正在同步的 goroutine 完成
• 简单冲突提示：若 target 文件被手动修改且 ModTime 新于 source，打印 warning 并跳过，不强制覆盖（避免静默丢失人工改动）

不复杂但容易忽略。写好监听、想清同步条件、守住边界情况，一个可用的同步工具就立住了。