如何在Golang中优雅处理文件操作错误_Golang文件错误处理示例

应使用 os.IsNotExist(err) 判断文件不存在，而非字符串匹配；os.Stat 有竞态风险，应直接 os.Open 并分类错误；Close() 必须检查错误；批量操作优先用 os.ReadDir 自控错误处理。

直接判断 os.Open 返回的 error 是否为 os.ErrNotExist

很多新手会用 strings.Contains(err.Error(), "no such file") 做判断，这不可靠——错误信息可能随系统语言或 Go 版本变化。os.ErrNotExist 是导出的变量，专用于标识文件不存在，语义明确且稳定。

• 永远用 errors.Is(err, os.ErrNotExist)（Go 1.13+）或 err == os.ErrNotExist（简单场景）
• 不要依赖错误字符串内容，尤其在跨平台部署时
• os.IsNotExist(err) 是兼容旧版本的推荐方式，内部做了类型断言和底层 syscall 错误映射

file, err := os.Open("config.json")
if err != nil {
    if os.IsNotExist(err) {
        log.Println("配置文件不存在，使用默认值")
        return loadDefaultConfig()
    }
    return fmt.Errorf("打开配置文件失败: %w", err)
}
defer file.Close()

用 os.Stat 预检文件状态，但别滥用

os.Stat 看似能提前知道文件是否存在、是否为目录、权限是否足够，但它引入一次额外系统调用，且存在竞态风险：即使 Stat 返回成功，后续 Open 仍可能失败（例如文件被其他进程删除或权限变更）。

• 仅在需要区分“不存在”“是目录”“权限拒绝”等不同语义时才用 os.Stat
• 如果只关心“能否读取”，直接 os.Open + 错误分类更高效、更安全
• 对性能敏感路径（如高频日志写入），避免先 Stat 再 Open

fi, err := os.Stat("data.bin")
if err != nil {
    if os.IsNotExist(err) {
        return errors.New("数据文件未生成")
    }
    if os.IsPermission(err) {
        return errors.New("无权访问数据文件")
    }
    return fmt.Errorf("检查文件状态失败: %w", err)
}
if !fi.Mode().IsRegular() {
    return errors.New("data.bin 不是普通文件")
}

写文件时必须检查 file.Close() 的返回值

很多人忽略 Close() 可能返回错误，尤其是写入缓冲未刷盘就关闭时（例如磁盘满、I/O 中断）。Go 的 *os.File.Close 会尝试 flush 并释放资源，失败意味着数据可能未持久化。

Mulan AI

画布式AI视频创作平台，轻松制作爆款视频

下载

• 所有显式调用 Close() 的地方都应处理其返回的 error
• 用 defer 时无法直接返回错误，可改用命名返回值或封装辅助函数
• 若需确保写入完成，优先用 file.Sync() 显式刷盘，再 Close()

f, err := os.Create("output.txt")
if err != nil {
    return err
}
defer func() {
    if cerr := f.Close(); cerr != nil && err == nil {
        err = cerr // 仅当主逻辑无错时，把 Close 错误作为最终返回
    }
}()
_, err = f.Write([]byte("hello"))
if err != nil {
    return err
}

批量文件操作中用 os.ReadDir 替代 filepath.WalkDir 控制错误传播

filepath.WalkDir 默认遇到任意子目录错误（如权限不足）就终止遍历，而实际需求常是“跳过问题项，继续处理其余”。os.ReadDir 返回 []fs.DirEntry，配合手动递归可精细控制错误处理粒度。

立即学习“go语言免费学习笔记（深入）”；

• os.ReadDir 不会因单个条目失败而中断，适合容错型扫描
• 它不解析符号链接目标，比 filepath.Walk 更轻量
• 注意：它只读当前目录，递归需自己实现，但正因如此才能决定每个子目录是否进入

entries, err := os.ReadDir("logs/")
if err != nil {
    log.Printf("无法读取 logs 目录: %v", err)
    return
}
for _, ent := range entries {
    if !ent.Type().IsRegular() {
        continue
    }
    path := filepath.Join("logs/", ent.Name())
    data, rerr := os.ReadFile(path)
    if rerr != nil {
        log.Printf("跳过损坏日志 %s: %v", path, rerr)
        continue
    }
    processLog(data)
}