用 filepath.Walk 遍历目录需手动防 symlink 循环：在 WalkFunc 中用 os.Lstat 判断 symlink，读取目标并归一化路径，用 map 记录已访问 clean 后的绝对路径，重复则 SkipDir；Windows 需特殊处理；校验需综合 size、mtime 和 sha256 哈希；清单用 JSON 格式，路径统一 ToSlash，含 path、size、mtime、hash 字段；并发需限速防资源耗尽。
如何用 filepath.Walk 遍历目录并避免 symlink 循环
直接用 filepath.Walk 会因软链接（symlink）形成循环遍历，导致 panic 或无限递归。Go 标准库不自动处理 symlink 跳转逻辑，必须手动判断。
- 在
filepath.WalkFunc回调里，先用os.Lstat检查路径是否为 symlink（fi.Mode()&os.ModeSymlink != 0） - 如果是 symlink，用
os.Readlink获取目标路径，再调用filepath.IsAbs判断是否为绝对路径；相对 symlink 可拼接后做filepath.Clean归一化 - 维护一个已访问路径的
map[string]bool（key 用filepath.Clean后的绝对路径），遇到重复路径直接return filepath.SkipDir - 注意：Windows 下 symlink 权限不同，需加
runtime.GOOS == "windows"分支处理os.Statvsos.Lstat差异
校验文件完整性该比对哪些字段
只比对文件名和大小极易误判——相同名字、大小的文件内容可能完全不同。实际生产中至少要覆盖三类信息：
-
os.FileInfo.Size()：快速筛掉明显缺失或截断的文件 -
os.FileInfo.ModTime()：辅助识别未更新但内容变更的场景（如日志轮转后重写） - 内容哈希：推荐
sha256（crypto/sha256），避免md5碰撞风险；小文件可全量读取，大文件需分块io.Copy到hash.Hash实例 - 不要依赖
os.FileInfo.Sys().(*syscall.Stat_t).Ino做唯一性判断——跨文件系统时 inode 不可比，且 Windows 无 inode 概念
如何生成和验证校验清单（manifest）
清单格式选 JSON 而非纯文本：结构清晰、易增字段（如 hash 算法标识）、天然支持嵌套路径。关键点在于路径标准化和字段可扩展性。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 生成时所有路径统一用
filepath.ToSlash转为正斜杠（/），避免 Windows \ 和 Unix / 混用导致比对失败 - 每个条目包含：
path（相对根目录）、size、mtime（Unix 时间戳）、hash（base64 编码的 sha256 值） - 验证脚本启动时先
os.Stat检查清单文件是否存在；若不存在，提示 “请先运行 --generate” 而非静默失败 - 验证过程中遇到缺失文件、大小不符、hash 不匹配，分别输出不同前缀错误信息（如
[MISS]、[SIZE]、[HASH]），方便 grep 过滤
并发读取文件计算 hash 的坑与取舍
开启 goroutine 并发算 hash 看似能提速，但在机械硬盘或高 IO 压力下反而更慢，且容易触发 open too many files 错误。
立即学习“go语言免费学习笔记（深入）”；
- 默认用单协程顺序处理：稳定、内存可控、错误堆栈清晰
- 如需并发，必须限制最大 goroutine 数（如
sem := make(chan struct{}, 4)），每次启动前sem ，完成后 <code> - 文件句柄数限制由
ulimit -n决定，Go 进程无法绕过；用os.Open后务必defer f.Close()，否则很快耗尽 - 大目录（>10k 文件）建议加进度提示：每处理 1000 个文件打印一次计数，避免用户以为卡死
路径标准化、哈希一致性、symlink 安全遍历——这三点漏掉任意一个，脚本在真实环境就会出错。尤其注意 Windows 上 symlink 处理和清单路径分隔符，不是写完 Linux 能跑就完事。
