Go语言os.ReadDir目录遍历_Golang文件列表获取新方法-Golang-PHP中文网

os.ReadDir比ioutil.ReadDir快在仅读取目录项名称和类型，跳过stat系统调用，实测耗时为其1/3～1/2；它返回fs.DirEntry而非os.FileInfo，需显式调用entry.Info()获取大小等信息。

go语言os.readdir目录遍历_golang文件列表获取新方法

os.ReadDir 比 ioutil.ReadDir 快在哪？

它不读取文件的完整 FileInfo（比如大小、修改时间、权限位），只解析目录项名称和类型（是否为目录），底层调用系统 getdents（Linux）或 FindFirstFile（Windows）时跳过 stat 系统调用。实测在含数万小文件的目录中，os.ReadDir 耗时通常只有 ioutil.ReadDir 的 1/3～1/2。

但注意：它返回的是 fs.DirEntry，不是 os.FileInfo。如果你后续需要文件大小或 modtime，得对每个 DirEntry 显式调用 entry.Info() —— 这会触发一次额外的 stat，抵消掉部分性能优势。

如何安全地递归遍历子目录？

os.ReadDir 本身不递归，需手动实现。关键点是：必须检查 DirEntry.IsDir()，再用 os.ReadDir 打开子路径；不能直接拼接字符串后调用 os.Stat 或 os.Open，否则遇到符号链接可能陷入死循环或越界访问。

用 filepath.Join 拼路径，避免硬拼 / 或
对每个 DirEntry 先调 entry.IsDir()，再决定是否递归
遇到 entry.Type()&fs.ModeSymlink != 0 且你不想跟随链接时，跳过或记录警告
递归前建议加深度限制（比如最大 32 层），防止环状符号链接导致栈溢出

示例片段：

func walkDir(path string, depth int) error {
	if depth > 32 {
		return errors.New("max depth exceeded")
	}
	entries, err := os.ReadDir(path)
	if err != nil {
		return err
	}
	for _, entry := range entries {
		fullPath := filepath.Join(path, entry.Name())
		if entry.IsDir() {
			if err := walkDir(fullPath, depth+1); err != nil {
				return err
			}
		} else {
			fmt.Println("file:", fullPath)
		}
	}
	return nil
}