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.Errorschannel，否则 goroutine 可能永久阻塞
设计健壮的同步逻辑：避免竞态与覆盖
监听到变更后，不能直接“复制过去”，要判断是否真需同步。典型策略如下：
立即学习“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 并跳过，不强制覆盖（避免静默丢失人工改动）
不复杂但容易忽略。写好监听、想清同步条件、守住边界情况，一个可用的同步工具就立住了。
