最常见原因是PATH未正确配置：macOS/Linux需将/usr/local/go/bin加入~/.zshrc并source，Windows需在系统环境变量Path中添加C:Goin，然后新开终端验证go version。
Go 安装后 go version 报错或找不到命令
最常见原因是 PATH 没配对，尤其 macOS/Linux 下用 brew install go 或手动解压安装后，go 二进制路径（比如 /usr/local/go/bin）没加进 shell 配置文件。
Windows 用户则要确认系统环境变量里 Path 是否包含 GOROOTin（默认是 C:Goin）。
验证方式：终端运行 which go（macOS/Linux）或 where go（Windows），没输出就说明没生效。
修复建议：
- macOS/Linux：在
~/.zshrc或~/.bash_profile末尾加export PATH=$PATH:/usr/local/go/bin，然后source ~/.zshrc - Windows：右键“此电脑”→属性→高级系统设置→环境变量→编辑
Path→新增C:Goin - 别漏掉重启终端，或者新开一个窗口再试
go version
用 os.ReadDir 还是 filepath.WalkDir 做文件遍历
两者都可用，但语义和适用场景不同：os.ReadDir 只读一层目录，返回 []fs.DirEntry，速度快、内存开销小，适合已知层级结构的同步（比如只同步某一级子目录）；filepath.WalkDir 递归遍历全树，自动处理符号链接、权限拒绝等错误回调，更适合完整目录镜像。
注意点：
-
os.ReadDir不保证顺序，如需稳定遍历（比如做增量比对），得手动sort.Slice -
filepath.WalkDir的回调函数里，err != nil时返回非nil可中断遍历，但常见误操作是忽略fs.SkipDir导致跳过子目录失败 - 如果目标路径含中文或特殊字符，两个函数都正常，但 Windows 下路径分隔符要用
filepath.Join而非硬写"\"
同步时如何安全判断文件是否变更
仅靠文件名和修改时间（ModTime()）不可靠：NFS、某些云盘、甚至 FAT32 分区的时间精度只有 2 秒，会导致漏同步或反复同步。
更稳妥的做法是组合使用：
- 先比对
Size()，大小不同直接同步 - 大小相同再比对
ModTime().UnixNano()，毫秒级精度仍可能不准，所以最后一步计算 SHA256（小文件）或分块校验（大文件） - 实际项目中，可先用
os.Stat获取基础信息，再按需打开文件计算哈希——避免每次同步都读全量内容 - Go 标准库没有内置快速分块哈希，但可用
io.Copy配合hash.Hash边读边算，10MB 以上文件建议限制单次读取64KB避免内存暴涨
用 fsnotify 实现实时监听但频繁触发重复事件
Linux/macOS 下 fsnotify 对同一文件的保存操作常触发多次 Write 或 Chmod 事件，尤其 VS Code、Sublime 等编辑器会先写临时文件再原子替换，导致监听到旧文件删除+新文件创建两件事。
缓解方法：
- 对每个事件加 100–500ms 去抖（debounce），用
time.AfterFunc延迟处理，期间新事件来就取消旧定时器 - 过滤掉
Chmod类事件（除非你真关心权限变化） - 记录最近处理过的文件路径 + 时间戳，3 秒内重复路径直接丢弃
- 别监听整个父目录，而是精确到需同步的子目录，减少事件噪音
fsnotify 依赖 ReadDirectoryChangesW，对移动/重命名事件支持弱，必要时得 fallback 到轮询。立即学习“go语言免费学习笔记（深入）”；
Go 文件同步工具的核心难点不在语法，而在路径处理的平台差异、时间精度陷阱、以及监听事件的噪声控制。哪怕只是本地双目录同步，也得提前想好：要不要保留空目录、遇到权限错误怎么退、软链接是否跟随——这些细节不定义清楚，跑几天就出问题。
