Golang Package跨平台开发的简单实践

我需要写一个golang的支持Linux，Windows，MacOS的包，可以使用FsStats获取系统上的文件系统信息，但是由于Mac，Linux，Windows上获取文件系统信息的方式不同，所以要根据系统使用不同的逻辑，我该如何实现在包的外部统一使用FsStats来实现获取文件系统信息？

为了在 Go 中实现跨平台的文件系统信息获取逻辑，可以利用 Go 提供的 build 标签功能，将不同平台的实现逻辑分别写在不同的文件中，然后在包的公共接口层提供一个统一的函数接口给外部调用。

以下是详细实现步骤：

1. 定义跨平台的统一接口

先定义一个结构和方法签名，供外部统一使用。例如：
fsstats/fsstats.go

package fsstats

type FileSystemStats struct {
    Total     uint64
    Free      uint64
    Available uint64
    Used      uint64
    FSName    string
    MountPath string
}

// FsStats 获取文件系统信息的统一入口
func FsStats() ([]FileSystemStats, error) {
    return getFsStats()
}

这里 getFsStats 是一个内部实现的函数，由不同平台具体实现。

2. 实现不同平台的逻辑

根据不同的操作系统，分别实现 getFsStats 方法，并使用 build 标签来区分平台。

Linux 实现
fsstats/fsstats_linux.go

//go:build linux

package fsstats

import (
    "syscall"
)

func getFsStats() ([]FileSystemStats, error) {
    var stats []FileSystemStats
    // 假设我们从 /proc/mounts 解析文件系统信息
    // 或者调用 syscall.Statfs 获取信息
    fs := syscall.Statfs_t{}
    err := syscall.Statfs("/", &fs)
    if err != nil {
        return nil, err
    }

    stats = append(stats, FileSystemStats{
        Total:     fs.Blocks * uint64(fs.Bsize),
        Free:      fs.Bfree * uint64(fs.Bsize),
        Available: fs.Bavail * uint64(fs.Bsize),
        Used:      (fs.Blocks - fs.Bfree) * uint64(fs.Bsize),
        FSName:    "ext4", // 示例
        MountPath: "/",
    })
    return stats, nil
}

Windows 实现
fsstats/fsstats_windows.go

//go:build windows

package fsstats

import (
    "syscall"
    "unsafe"
)

func getFsStats() ([]FileSystemStats, error) {
    var stats []FileSystemStats
    kernel32 := syscall.NewLazyDLL("kernel32.dll")
    getDiskFreeSpaceEx := kernel32.NewProc("GetDiskFreeSpaceExW")

    var freeBytesAvailable, totalNumberOfBytes, totalNumberOfFreeBytes int64
    _, _, err := getDiskFreeSpaceEx.Call(
        uintptr(unsafe.Pointer(syscall.StringToUTF16Ptr("C:\\"))),
        uintptr(unsafe.Pointer(&freeBytesAvailable)),
        uintptr(unsafe.Pointer(&totalNumberOfBytes)),
        uintptr(unsafe.Pointer(&totalNumberOfFreeBytes)),
    )
    if err != nil && err.Error() != "The operation completed successfully." {
        return nil, err
    }

    stats = append(stats, FileSystemStats{
        Total:     uint64(totalNumberOfBytes),
        Free:      uint64(totalNumberOfFreeBytes),
        Available: uint64(freeBytesAvailable),
        Used:      uint64(totalNumberOfBytes - totalNumberOfFreeBytes),
        FSName:    "NTFS", // 示例
        MountPath: "C:\\",
    })
    return stats, nil
}

MacOS 实现
fsstats/fsstats_darwin.go

//go:build darwin

package fsstats

import (
    "syscall"
)

func getFsStats() ([]FileSystemStats, error) {
    var stats []FileSystemStats
    fs := syscall.Statfs_t{}
    err := syscall.Statfs("/", &fs)
    if err != nil {
        return nil, err
    }

    stats = append(stats, FileSystemStats{
        Total:     fs.Blocks * uint64(fs.Bsize),
        Free:      fs.Bfree * uint64(fs.Bsize),
        Available: fs.Bavail * uint64(fs.Bsize),
        Used:      (fs.Blocks - fs.Bfree) * uint64(fs.Bsize),
        FSName:    "apfs", // 示例
        MountPath: "/",
    })
    return stats, nil
}

3. 外部调用统一接口

外部调用时，无需关注平台差异，只需调用 fsstats.FsStats()

package main

import (
    "fmt"
    "log"
    "yourmodule/fsstats"
)

func main() {
    stats, err := fsstats.FsStats()
    if err != nil {
        log.Fatalf("Failed to get file system stats: %v", err)
    }

    for _, stat := range stats {
        fmt.Printf("FileSystem: %s, Total: %d, Used: %d, Free: %d, MountPath: %s\n",
            stat.FSName, stat.Total, stat.Used, stat.Free, stat.MountPath)
    }
}

总结:
跨平台兼容通过 build 标签在不同文件中实现不同平台的逻辑。
统一接口在公共包中定义对外暴露的接口，屏蔽平台细节。
灵活扩展可以轻松为新平台添加实现，而不影响现有代码。
这种模式是 Go 跨平台开发的最佳实践，符合模块化和代码清晰性的要求。