Go文件操作错误显式返回需检查，核心是os包预定义变量（如ErrNotExist）和*os.PathError结构，后者含Op、Path、Err字段；打开模式不匹配或路径处理不当是常见根源。
Go 文件操作出错，基本都体现在 error 值上。它不是隐藏的异常，而是显式返回、必须检查的值。常见错误类型主要来自 os 包，核心是几个预定义变量和可识别的错误结构。
os 包内置的标准错误变量
这些是 Go 标准库中定义好的、可直接用 errors.Is 判断的错误：
-
os.ErrNotExist：文件或目录不存在。最常见于
os.Open、os.Stat失败时。 -
os.ErrExist：文件或目录已存在。多见于
os.Mkdir或os.Create时加了O_EXCL但目标已存在。 - os.ErrPermission：权限不足。比如以只读方式尝试写入，或无权访问某目录。
-
os.ErrInvalid：无效操作。例如对已关闭的文件句柄调用
Read，或传入非法参数（如空路径）。 - os.ErrClosed：文件已被关闭，却继续读写（Go 1.16+ 显式暴露该错误）。
可识别的底层错误结构
很多错误实际是 *os.PathError 类型，它封装了操作名、路径和原始错误，便于定位问题根源：
- 字段
Op表示操作（如"open"、"stat"、"chmod"） - 字段
Path给出具体路径（常用于日志排查） - 字段
Err是底层错误（可能是系统 errno，也可能是其他 error）
可用类型断言提取：if perr, ok := err.(*os.PathError); ok { fmt.Printf("操作 %s 失败于路径 %s", perr.Op, perr.Path) }
文件打开模式不匹配导致的 error
调用 os.Open 后试图写入，会报 "bad file descriptor" ——这不是独立错误类型，而是系统级 errno 转换后的 *os.SyscallError。根本原因是：
-
os.Open等价于os.OpenFile(name, os.O_RDONLY, 0)，只读打开 - 后续调用
Write或Seek会失败 - 正确做法是用
os.OpenFile显式指定模式，如os.O_RDWR | os.O_CREATE
跨平台与路径相关 error
看似“找不到文件”，实际可能是路径处理不当：
- 相对路径基于进程当前工作目录（
os.Getwd()），不是源码所在目录 - Windows 用
\，Linux/macOS 用/；硬编码分隔符会导致跨平台失败 -
解决方法：统一用
filepath.Join("dir", "file.txt")拼接，用filepath.Abs转绝对路径再操作
基本上就这些。
