应优先使用filepath.walkdir（go 1.16+），通过filepath.abs标准化根路径、filepath.rel提取相对路径，配合fs.direntry判断类型与名称跳过无关目录，对权限错误返回nil继续遍历，并用sha256按需校验内容以准确识别“仅a有”“仅b有”“内容不同”三类状态。
如何用 filepath.WalkDir 安全遍历两个目录并提取相对路径
直接用 filepath.Walk 容易因符号链接或权限问题 panic，filepath.WalkDir 是 Go 1.16+ 的推荐替代，它返回 fs.DirEntry 而非 os.FileInfo，避免提前 Stat 开销，也更易跳过错误。
关键点在于：必须用 filepath.Rel 将绝对路径转为相对于根目录的路径，否则无法对齐比对。若不处理，同一文件在不同根下路径完全不同，比对会完全失效。
- 调用前确保两个根路径已用
filepath.Abs标准化，消除../或软链干扰 - 在
WalkDirFunc中遇到fs.ErrPermission或fs.ErrNotExist应记录但继续，不能 return 错误中断整个遍历 - 忽略
.git、__pycache__等目录时，检查entry.IsDir()和entry.Name()，不要依赖后缀
比对逻辑里为什么必须区分「仅A有」「仅B有」「内容不同」三类状态
同步任务不是简单删+拷贝——比如目标端已有同名目录但为空，源端是完整项目，此时应覆盖而非报错；又比如两个文件修改时间相同但大小不同，说明可能被静默修改过，必须以内容 hash 判定是否真相同。
只靠 os.FileInfo 的 ModTime() 和 Size() 不可靠：NFS 挂载可能丢失纳秒精度，Windows FAT32 时间戳粒度为 2 秒，且用户可能 touch 文件却不改内容。
- 「仅A有」→ 生成
copy任务（含 mkdir -p 逻辑） - 「仅B有」→ 生成
delete或move任务，取决于是否启用 --dry-run 或 --backup - 「路径存在但内容不同」→ 先用
sha256.Sum256计算前 4KB（快速筛），再按需全量 hash；小文件（
生成同步任务时如何避免 cp / rsync 命令注入风险
如果工具最终输出 shell 脚本供执行，直接拼接 fmt.Sprintf("cp %s %s", src, dst) 是严重漏洞：路径含空格、$、`、; 会导致命令截断或执行任意代码。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
安全做法是不用 shell 解析，而是调用 exec.Command 并传入参数切片，让 OS 直接执行二进制：
cmd := exec.Command("cp", "-r", srcPath, dstPath)
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
err := cmd.Run()
若必须输出可执行脚本（如跨平台分发），则对每个路径用单引号包裹 + 内部单引号转义：'foo'"'"'bar'，而不是依赖 shellescape 第三方库——这会增加依赖且多数场景不必要。
为什么默认不递归比较 symlink 目标，但提供 --follow-symlinks 开关
符号链接本质是路径字符串，其目标可能不存在、跨分区、甚至指向循环结构（如 A → B → A）。无条件跟随会导致无限遍历或权限拒绝，而大多数同步场景只需同步链接本身（即复制 ln -s target name 这条元信息）。
开启 --follow-symlinks 后，需在 Walk 前用 os.Stat 替换 os.Lstat，并在发现 symlink 时用 filepath.EvalSymlinks 解析真实路径；同时要维护已访问路径集合，防止环路。
- 未开启时：把 symlink 当普通文件处理，读取其指向路径字符串作为“内容”参与比对
- 开启后：若解析失败（如目标不存在），仍按原 symlink 路径记录，避免比对中断
- Windows 上
os.Readlink可能返回空字符串，需 fallback 到os.Lstat的Mode() & os.ModeSymlink != 0判定
路径规范化和 symlink 处理是实际落地时最常出错的部分，尤其混合 Windows/Linux 路径分隔符或挂载 CIFS/NFS 时，建议始终在内存中统一用 filepath.ToSlash 归一化后再比对。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
