Go os.ReadFile 读取目录时返回错误怎么解释

如果把目录路径传给 os.ReadFile，返回错误通常不是 Go 没找到目录，而是调用目标和路径类型不匹配：os.ReadFile 要读取的是一个文件内容，目录应该交给 os.ReadDir 或 File.ReadDir。先检查 err，再用 *os.PathError 查看失败操作和路径，通常比解析错误字符串可靠。

为什么目录路径会落到 os.ReadFile 的错误分支

os.ReadFile(name) 的参数只是一个路径字符串，它不会替你把“文件”和“目录”当成同一种资源处理。路径解析成功，只能说明这个名字对应某个文件系统条目；当底层读取动作要求普通文件，而条目实际是目录时，调用就会返回错误。

因此，下面两件事要分开看：路径是否存在，以及路径是否符合当前 API 的资源类型。错误可能表现为包含 is a directory、invalid argument 或平台相关文本，但不要把某一条英文错误信息当成跨平台契约。

先用 FileInfo 判断路径究竟是什么

排查时可先调用 os.Stat。它返回的 FileInfo 能告诉我们目标是否为目录；若 Stat 本身失败，则优先处理路径不存在、权限或符号链接等问题，不要直接把原因归到 ReadFile。

package main

import (
	"errors" // 用于沿错误链识别 *os.PathError
	"fmt"
	"os"
)

func inspectPath(path string) error {
	info, err := os.Stat(path)
	if err != nil {
		var pathErr *os.PathError
		if errors.As(err, &pathErr) {
			// PathError 保留了失败操作和原始路径，适合记录排查上下文。
			return fmt.Errorf("检查 %q 时执行 %s 失败: %w", pathErr.Path, pathErr.Op, err)
		}
		return err
	}

	if info.IsDir() {
		return fmt.Errorf("%q 是目录，应使用目录读取 API", path)
	}
	return nil
}

这里没有比较 err.Error() 的完整字符串，而是用 errors.As 沿包装链寻找 *os.PathError。info.IsDir() 只负责确认类型，真正读取内容仍应交给后面的文件 API。

文件和目录应该选择不同的 API

如果目标是配置文件、模板或文本文件的全部字节，继续使用 os.ReadFile；如果目标是拿到目录下的条目名称，就应该使用 os.ReadDir。两者返回的数据结构不同，这也是最不容易混淆的判断标准。

package main

import (
	"fmt"
	"os"
)

func listNames(dir string) error {
	entries, err := os.ReadDir(dir)
	if err != nil {
		return fmt.Errorf("读取目录 %q 失败: %w", dir, err)
	}

	for _, entry := range entries {
		// DirEntry 先提供名称；只有需要时再调用 IsDir 或 Info。
		fmt.Printf("%s\\t目录=%t\\n", entry.Name(), entry.IsDir())
	}
	return nil
}

若需要在一个已打开的资源上继续读取，可写成 file, err := os.Open(dir)，成功后用 defer file.Close()，再调用 file.ReadDir(-1)。不要把目录打开后又交给 ReadFile 期待得到目录内容。

错误处理要保留原始上下文

对外返回错误时使用 %w 包装，可以让上层继续使用 errors.Is 或 errors.As 判断。日志里至少保留操作名、路径和原始错误；不要只写一句“读取失败”，否则目录误传、路径不存在和权限不足会被混在一起。

var pathErr *os.PathError
if errors.As(err, &pathErr) {
	// 只把稳定的结构化字段用于分类，文本用于给人看。
	fmt.Printf("op=%s path=%s cause=%v\\n", pathErr.Op, pathErr.Path, pathErr.Err)
}

最终的修复方向很明确：调用方要的是文件字节，就校验路径不是目录后调用 os.ReadFile；调用方要的是目录项，就改用目录 API。反复重试同一个目录路径不会改变资源类型。

相关问题

os.ReadFile 读取空文件会报错吗？

不会。空文件仍然是普通文件，成功时可以得到长度为 0 的 []byte，并且 err == nil。

只判断错误字符串中的 “is a directory” 可以吗？

不建议。错误文本可能随操作系统变化；优先用 errors.As 识别 *os.PathError，再结合 os.Stat 判断目标类型。

目录为空时 os.ReadDir 返回什么？

空目录仍是成功读取，通常得到空的目录项切片和 nil 错误；不要把“没有条目”当成“目录读取失败”。