filepath.Walk不能直接比文件夹差异，因其仅遍历单路径树且无跨目录比对能力，需手动维护两棵树状态并逐节点比较，同时注意路径标准化、符号链接处理及分层校验策略。
filepath.Walk 为什么不能直接比文件夹差异
因为 filepath.Walk 只负责遍历单个路径树，不提供跨目录比对能力——它不会告诉你某个文件在 A 目录存在、在 B 目录缺失，也不会自动对齐同名文件做内容校验。你得自己维护两棵树的状态，再逐节点比较。
常见错误现象：filepath.Walk 分别跑两次后用 map[string]os.FileInfo 存结果，但没处理路径标准化（比如 ./a 和 a 被当不同 key），或忽略 symlink 循环导致 panic。
- 务必用
filepath.Clean或filepath.Abs统一路径表示，否则同个文件可能被算作“差异” - 如果要支持符号链接，需显式设置
filepath.WalkOption（Go 1.16+）并传入filepath.SkipDir避免无限递归 -
os.FileInfo的ModTime()和Size()在 FAT32 或某些 NFS 上可能不准，仅靠它们判断“内容相同”有风险
怎么安全地获取两个目录的相对路径集合
核心是把绝对路径转成相对于根目录的“逻辑路径”，才能对齐比对。比如 /tmp/a/x.txt 和 /tmp/b/x.txt，应提取出共同前缀后得到 x.txt 和 x.txt，而非直接比完整路径。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先用
filepath.Abs获取两个目录的绝对路径，再用strings.TrimPrefix剥离公共前缀（注意加string(filepath.Separator)避免误切，如/a和/ab） - 对每个
filepath.Walk回调中的path，都做一次rel, err := filepath.Rel(root, path)，失败则跳过（比如跨分区或权限不足） - 用
map[string]*fileMeta存储，其中fileMeta至少含size、modTime、isDir、err字段——有些路径可能可遍历但不可 stat
比内容时该不该读全文件？
不该，尤其面对大文件或大量小文件时。直接 ioutil.ReadFile 或 os.ReadFile 容易 OOM 或拖慢整体速度。
更合理的分层策略：
- 第一层：比路径是否存在（A 有 B 无 → “only in A”）
- 第二层：比
os.FileInfo的Size()和ModTime().Unix()—— 大部分场景已足够筛掉 95% 不同文件 - 第三层：仅当 size + mtime 完全一致，才用
sha256.Sum256分块读取（比如每次读 64KB）计算哈希；或者更轻量地用bytes.Equal比前 1KB 和后 1KB（对文本/配置类文件够用） - 注意：Windows 下 NTFS 默认不更新 mtime，若目标环境不确定，建议默认跳过 mtime 比较，只依赖 size + hash
如何让对比结果可读又不失精度
用户真正需要的不是原始数据结构，而是能一眼看出“哪些文件多了、少了、改了”。输出格式必须带上下文，比如路径层级缩进、状态标识符、时间戳对齐。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 定义枚举状态：
OnlyInA、OnlyInB、DiffSize、DiffHash、Identical，避免用字符串硬编码 - 打印时统一用
fmt.Printf("%-12s %s\n", status, relPath)，保证列对齐；对长路径做截断（如.../deep/nested/file.go） - 如果支持 JSON 输出（比如 CI 场景），字段名用小写+下划线（
only_in_a），别用 Go struct tag 默认的驼峰，否则下游解析容易出错 - 别忘了统计汇总行：共多少文件、多少差异项、耗时多少——这对调试和性能 baseline 很关键
路径标准化和状态分层是真正卡住人的地方，很多人写到一半才发现 filepath.Walk 返回的路径格式不一致，或者 hash 比对逻辑被空文件或权限错误打断。这些细节不提前兜住，工具跑两分钟就 panic。
