使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
linux/macos下最可靠文件唯一标识是dev+inode组合，windows需fallback至绝对路径+大小+纳秒级修改时间；uuid与哈希因随机性、性能及并发读不一致等问题不适合作为文件id。
直接用 os.Stat 获取文件的 dev 和 inode 组合，是 Linux/macOS 下最轻量、最可靠的文件唯一标识方案；Windows 需 fallback 到 filepath.Abs + os.FileInfo.Size() + os.FileInfo.ModTime() 的组合，但要注意时钟精度和并发修改风险。
为什么不用 UUID 或哈希？
UUID 完全随机，和文件无关，无法解决“同一文件多次生成 ID 不一致”的问题；而全量计算 md5 或 sha256 虽然内容级唯一，但对大文件（如几百 MB 日志）极慢，且无法区分硬链接——两个硬链接指向同一份数据，理应共享 ID，但路径不同会导致哈希值不同。
更关键的是：哈希无法应对“文件正在被写入”的场景，读到中间可能得到不一致的内容快照，ID 就失去意义。
-
os.Stat是系统调用，开销近乎为零 -
dev+inode在单机生命周期内天然唯一且稳定（只要不 reboot 且不触发 inode 回收） - 硬链接自动命中同一
inode，无需额外处理
Linux/macOS：用 syscall.Stat_t.Dev 和 Ino 构造 ID
Go 标准库的 os.FileInfo.Sys() 返回平台相关结构体，需类型断言为 *syscall.Stat_t（注意导入 syscall 包）。Dev 和 Ino 均为 uint64，拼接成字符串或用 binary.PutUvarint 编码为字节序列均可。
fi, _ := os.Stat("/path/to/file")
if s, ok := fi.Sys().(*syscall.Stat_t); ok {
id := fmt.Sprintf("%d:%d", s.Dev, s.Ino)
// 或：idBytes := append(
// make([]byte, 0, 16),
// binary.AppendUvarint(nil, uint64(s.Dev))...,
// binary.AppendUvarint(nil, uint64(s.Ino))...,
// )
}
- 必须检查
ok，Windows 下fi.Sys()返回*syscall.Win32FileAttributeData，断言失败 -
Dev在容器中可能恒为 0（如 overlayfs），此时需结合挂载点路径判断是否跨文件系统 - 不要用
fmt.Sprintf("%x:%x", s.Dev, s.Ino)—— 十六进制会丢失前导 0，导致不同设备号误判为相同
Windows：fallback 到绝对路径 + 元信息组合
Windows 没有稳定的 inode 概念，syscall.Stat_t 的 Ino 字段不可靠。可靠做法是：获取绝对路径（消除 ../. 和符号链接影响），再叠加文件大小与最后修改时间（纳秒级精度）。
abs, _ := filepath.Abs(path)
fi, _ := os.Stat(path)
id := fmt.Sprintf("%s:%d:%d", abs, fi.Size(), fi.ModTime().UnixNano())
- 必须用
filepath.Abs，否则C:\a\b\..\c.txt和C:\a\c.txt会被视为不同文件 -
ModTime().UnixNano()在 FAT32 上只有 2 秒精度，若需更高可靠性，可加fi.Sys().(*syscall.Win32FileAttributeData).CreationTime - 该组合仍可能碰撞：同一路径下，文件被删后立即以相同大小和时间重建——但这是业务层需接受的边界情况，比哈希更轻、比 UUID 更语义化
跨平台封装时最容易忽略的坑
别在运行时动态决定用哪种策略——编译期就该通过 // +build windows 分离实现，避免反射或接口抽象带来的性能损耗和维护成本。
- 硬链接检测不能只看
os.Link是否报错，要靠os.Stat后比对os.FileInfo.Sys()中的底层字段（Linux/macOS 看Ino，Windows 看FileIndexLow+FileIndexHigh） - 容器环境（尤其是 rootless podman）中，
dev可能全为 0，此时建议记录/proc/mounts中的 device name，拼进 ID - 如果 ID 用于数据库主键或分布式缓存 key，务必对最终字符串做
strings.ReplaceAll(id, ":", "_")，避免冒号引发解析歧义
真正难的不是生成 ID，而是明确你的“唯一”到底指什么：是单机瞬时唯一？还是跨重启一致？是否容忍硬链接差异？这些决定了你该砍掉哪部分信息、该在什么环节加锁、以及要不要引入外部协调服务。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
