Go io/fs FileInfo.ModTime 怎样读取虚拟文件时间

读取虚拟文件时间时，入口不是操作系统的 os.Stat，而是先对实现了 io/fs.FS 的文件系统调用 fs.Stat，再从返回的 fs.FileInfo 调用 ModTime()。这个时间由具体的文件系统实现提供；如果实现没有可靠的修改时间，返回的可能是零值，因此不能把它自动当成宿主机上的真实更新时间。

用 fs.Stat 取得 FileInfo，再读取 ModTime

io/fs 把文件系统抽象成 FS 接口。fs.Stat 接收一个文件系统和相对路径，返回描述该路径的 FileInfo；接口中的 ModTime() 返回 time.Time。因此实际读取过程只有一个稳定边界：先确认 err == nil，再从 info 取时间。

package main

import (
    "fmt"
    "io/fs"
    "time"
)

func readModTime(fsys fs.FS, name string) (time.Time, error) {
    // Stat 负责向具体 FS 请求文件元数据，失败时不要使用不完整的 info。
    info, err := fs.Stat(fsys, name)
    if err != nil {
        return time.Time{}, fmt.Errorf("读取 %q 的文件信息: %w", name, err)
    }

    // ModTime 返回的是实现提供的时间；它不保证一定是宿主机时间。
    return info.ModTime(), nil
}

这里的 name 仍然遵循 io/fs 的路径规则，例如使用 assets/config.json，而不是以斜杠开头的绝对路径。图1把访问边界、元数据对象和时间展示分开，重点是理解 ModTime 只是 FileInfo 的一个字段。

MapFS 中显式设置时间，并处理零值

写测试或演示虚拟文件系统时，testing/fstest.MapFS 很适合构造内存文件。它的 MapFile 有 Data、Mode 和 ModTime 等字段；你设置的 ModTime 会作为文件信息返回。没有设置时，time.Time{} 的零值就应该被视为“没有可用时间”，而不是 0001 年的业务事件。

package main

import (
    "fmt"
    "io/fs"
    "testing/fstest"
    "time"
)

func showVirtualTime() error {
    createdAt := time.Date(2026, time.January, 12, 9, 30, 0, 0, time.UTC)
    mem := fstest.MapFS{
        "assets/app.css": &fstest.MapFile{
            // Data 和 Mode 描述虚拟文件本身，时间由 ModTime 单独提供。
            Data:    []byte("body { color: #123456; }"),
            ModTime: createdAt,
        },
    }

    info, err := fs.Stat(mem, "assets/app.css")
    if err != nil {
        return err
    }
    modified := info.ModTime()
    if modified.IsZero() {
        // 零值表示实现没有提供可用修改时间，交给展示层决定文案。
        fmt.Println("修改时间：未知")
        return nil
    }
    fmt.Println("修改时间：", modified.UTC().Format(time.RFC3339))
    return nil
}

示例把时间固定为 UTC，是为了让测试和日志在不同机器上有一致的文字结果。生产代码若要显示本地时间，应在展示层明确加载时区；不要在读取元数据时偷偷改变时间含义。

零值、错误和时间精度要分开判断

特别是在嵌入资源、内存文件或远程文件系统中，修改时间可能只是打包工具或后端协议提供的元数据。它适合做排序、缓存提示或页面展示的输入，但是否足以作为内容变更依据，要看对应 FS 的契约。

写读取函数时的四项检查

• 路径是否符合 io/fs.ValidPath 规则，并且与所用 FS 的根目录约定一致？
• 是否在 fs.Stat 返回成功后才调用 ModTime()？
• 是否用 IsZero() 处理“没有时间”，而不是直接格式化？
• 是否在展示、排序和缓存判断中分别说明时区、精度与可靠性边界？

这样写出来的代码既能读取真实目录，也能读取嵌入资源或测试用的 MapFS；真正变化的只是 FS 实现，而不是上层对 FileInfo 的使用方式。

常见问题

FileInfo.ModTime 会自动读取本机文件时间吗？

不会。它返回的是当前 FS 实现提供的元数据；只有使用操作系统文件系统并且该实现提供了相应值时，才可能对应本机文件的修改时间。

为什么拿到的 ModTime 看起来是空的？

先检查 fs.Stat 是否报错，再检查 info.ModTime().IsZero()。虚拟文件系统没有设置时间时，零值是正常的元数据状态。

可以直接用 ModTime 判断资源内容是否变化吗？

不能一概而论。时间的来源、精度和更新策略由具体 FS 决定；如果需要强一致判断，应结合内容摘要或实现提供的版本字段。