如何在Go中跨平台跨文件系统获取唯一文件标识？

各平台原生文件唯一标识获取 #

Linux: Inode + 设备ID #

• inode是文件系统内的唯一标识，但仅在同一挂载卷内有效，必须结合设备ID才能实现全局唯一。
• 获取方式：通过stat命令或stat()系统调用，从返回的struct stat中提取st_ino（inode值）和st_dev（设备ID）。

Windows: 文件ID（File ID） #

• NTFS等现代文件系统提供卷内唯一的64位文件ID，结合卷ID可实现全局唯一标识。
• 获取方式：调用GetFileInformationByHandle() API，拼接返回的BY_HANDLE_FILE_INFORMATION中nFileIndexHigh和nFileIndexLow得到完整文件ID；或使用fsutil file queryfileid <文件路径>命令。

macOS: Inode + 设备ID #

• 逻辑与Linux一致，HFS+、APFS等文件系统用inode标识文件，搭配设备ID实现全局唯一。
• 获取方式：通过stat命令或stat()系统调用，从struct stat中提取st_ino和st_dev。

现成跨平台库现状 #

目前没有完全贴合需求的开箱即用库，但可基于基础工具库封装：

• 借助golang.org/x/sys直接调用各平台原生系统调用（核心实现）
• 用github.com/pkg/errors简化跨平台错误处理
• 用github.com/mitchellh/go-homedir处理用户目录路径等通用逻辑

基于Go x/sys的系统调用实现示例 #

Linux 端 #

package main

import (
    "fmt"
    "golang.org/x/sys/unix"
)

func getFileUniqueID(path string) (uint64, uint64, error) {
    var stat unix.Stat_t
    if err := unix.Stat(path, &stat); err != nil {
        return 0, 0, err
    }
    return stat.Ino, uint64(stat.Dev), nil
}

func main() {
    inode, devID, err := getFileUniqueID("/tmp/test.txt")
    if err != nil {
        panic(err)
    }
    fmt.Printf("Inode: %d, 设备ID: %d\n", inode, devID)
}

Windows 端 #

package main

import (
    "fmt"
    "golang.org/x/sys/windows"
)

func getFileUniqueID(path string) (uint64, error) {
    handle, err := windows.CreateFile(
        windows.StringToUTF16Ptr(path),
        windows.GENERIC_READ,
        windows.FILE_SHARE_READ|windows.FILE_SHARE_WRITE|windows.FILE_SHARE_DELETE,
        nil,
        windows.OPEN_EXISTING,
        windows.FILE_ATTRIBUTE_NORMAL,
        0,
    )
    if err != nil {
        return 0, err
    }
    defer windows.CloseHandle(handle)

    var info windows.ByHandleFileInformation
    if err := windows.GetFileInformationByHandle(handle, &info); err != nil {
        return 0, err
    }
    return uint64(info.FileIndexHigh)<<32 | uint64(info.FileIndexLow), nil
}

func main() {
    fileID, err := getFileUniqueID("C:\\temp\\test.txt")
    if err != nil {
        panic(err)
    }
    fmt.Printf("文件ID: %d\n", fileID)
}

macOS 端 #

package main

import (
    "fmt"
    "golang.org/x/sys/unix"
)

func getFileUniqueID(path string) (uint64, uint64, error) {
    var stat unix.Stat_t
    if err := unix.Stat(path, &stat); err != nil {
        return 0, 0, err
    }
    return stat.Ino, uint64(stat.Dev), nil
}

func main() {
    inode, devID, err := getFileUniqueID("/tmp/test.txt")
    if err != nil {
        panic(err)
    }
    fmt.Printf("Inode: %d, 设备ID: %d\n", inode, devID)
}

文件标识的局限性 #

• 跨卷失效：inode、文件ID均为卷内唯一，文件移动到其他挂载卷会生成新标识。
• 文件系统兼容问题：FAT32等老旧文件系统不支持原生唯一标识，需 fallback 到文件大小+修改时间等组合方案。
• 删除重建混淆：删除文件后新建同名文件会获得新标识，无法区分原文件与新文件。
• 硬链接歧义：Linux/macOS下硬链接共享同一inode，无法通过inode区分硬链接与原文件。

跨挂载卷查找文件的实现思路 #

若持有旧路径+文件标识，需遍历所有挂载卷扫描比对：

1. 获取所有挂载卷：
   • Linux：读取/proc/mounts解析挂载点
   • Windows：调用GetLogicalDriveStrings()获取所有盘符
   • macOS：读取/etc/fstab或解析diskutil list输出
2. 遍历文件并比对：用递归遍历（如Go的filepath.Walk）扫描卷内文件，逐个获取标识并与目标比对。
3. 优化策略：
   • 缓存已扫描的标识与路径，减少重复扫描
   • 跳过系统目录、临时目录等非用户操作目录
   • 结合文件大小、修改时间等辅助信息缩小比对范围，提升效率

内容的提问来源于stack exchange，提问作者Eric '3ToedSloth'