如何正确理解 Go 中 os.Stat() 获取目录的 Size() 值？

Go 中调用 os.Stat() 获取目录的 FileInfo.Size() 返回的是该目录自身在文件系统中的元数据占用大小（如 ext4 中通常为 4096 字节），而非其下所有文件内容的总和；此值由操作系统和文件系统决定，不可跨平台直接解释为“子项数量”或“目录容量”。

先澄清一个常见的误解：当你用 Go 的 os.Stat() 去查一个目录的 FileInfo.Size() 时，它返回的可不是目录里所有文件加起来的体积，而是这个目录自己在文件系统里占用的“元数据空间”——在 ext4 下通常就是 4096 字节。这个值到底是多少，完全取决于操作系统和文件系统，不能简单地把它理解成“目录下有多少子项”或者“目录容量”。

在 Go 里，os.Stat() 和 os.Lstat() 返回的 os.FileInfo 接口定义了 Size() int64 方法。对普通文件来说，这个值很明确——就是文件内容的字节长度。但换成目录（或者设备文件、命名管道这类特殊文件），文档里写得很清楚：

“length in bytes for regular files; system-dependent for others”

翻译过来就是：普通文件按字节算，其他类型则依赖系统。所以目录的 Size() 本质上是操作系统和底层文件系统共同决定的实现细节，跨平台时语义并不一致。

举个具体的例子：在 Linux 的 ext4 文件系统里，一个空目录的 Size() 通常返回 4096。这 4096 正是该目录底层目录项（directory entry）所占的一个磁盘块大小，里面存着子目录/文件的 inode 编号和名称映射。随着目录里条目增多，文件系统可能会分配更多的块，Size() 就可能变成 8192、12288 等。但注意，它始终只是目录自身结构的存储开销，而不是里面所有文件体积的总和。

package main

import (
    "fmt"
    "os"
)

func main() {
    fi, err := os.Stat("/tmp")
    if err != nil {
        panic(err)
    }
    fmt.Printf("Directory '/tmp' Size(): %d bytes\n", fi.Size()) // e.g., 4096 on ext4
    fmt.Printf("IsDir: %v\n", fi.IsDir())                         // true
}

⚡ 几个需要留意的点：

• 别拿 Size() 去估算目录总容量。真想统计目录下所有文件的内容大小，得老老实实递归遍历——比如用 filepath.WalkDir，然后对每个常规文件累加 Size()。
• 硬链接会影响逻辑体积，但不会影响目录自身的 Size()。同一个文件被多个硬链接引用时，内容只存一份，Size() 也只计一次，而目录的 Size() 完全不管这层关系。
• 不同文件系统表现差异很大。XFS、Btrfs、ZFS 或者 macOS 的 APFS，对目录 Size() 的实现可能完全不同，有些甚至固定返回 0 或 1。
• os.Lstat() 和 os.Stat() 在目录上行为一致。两者都不跟随符号链接，所以如果对符号链接目录调用，Size() 返回的是链接文件本身的大小（即路径字符串的长度），而不是目标目录的大小。

总的来说，FileInfo.Size() 是一个底层、系统相关的属性。对目录而言，它本质上就是“目录数据块的已分配空间”，属于文件系统内部的实现细节。开发者最好不要给它赋予任何业务语义。如果需要知道目录内容的总大小、文件数量或者深度信息，那就老老实实写显式遍历，同时做好错误处理和循环引用防护（比如符号链接环）。