如何在Go语言中处理os.Stat返回的‘no such file or directory’错误？

首先明确：os.IsNotExist是Go标准库设计用来统一判断各类文件/目录不存在错误的工具，包括os.Stat、os.Open等调用返回的"no such file or directory"类错误。你遇到的无法捕获的情况，几乎都是因为错误被二次包装（比如用fmt.Errorf、errors.Wrap等工具重新封装过）导致的。

一、原生os调用的错误处理（无包装） #

如果是直接调用os.Stat、os.Open等方法返回的错误，直接用os.IsNotExist完全可以覆盖所有“文件不存在”场景：

fileInfo, err := os.Stat(absolutePath)
if err != nil {
    if os.IsNotExist(err) {
        // 处理文件不存在的情况，返回默认值
        return defaultValue, nil
    }
    // 处理其他错误
    return nil, fmt.Errorf("failed to stat file: %w", err)
}

这里的os.IsNotExist会自动识别底层系统返回的各类“不存在”错误，不管是os.Stat触发的，还是os.Open触发的"open <path>: no such file or directory"都能捕获。

二、处理被包装过的错误 #

如果错误经过了包装（比如上层代码用fmt.Errorf("%w", err)或者第三方库的错误包装），此时需要用errors.Is配合os.ErrNotExist来穿透包装检查原始错误：

import "errors"

// 假设err是被包装过的错误
if errors.Is(err, os.ErrNotExist) {
    return defaultValue, nil
}

errors.Is会递归检查错误链中的所有错误，判断是否有和os.ErrNotExist匹配的原始错误，这是Go 1.13+推荐的处理包装错误的方式。

三、常见误区 #

你觉得os.IsNotExist无法捕获某些错误，通常是因为错误被包装后，直接用os.IsNotExist检查的是包装后的错误对象，而非原始的os.ErrNotExist。比如：

// 错误的包装方式（丢失了原始错误链）
return nil, fmt.Errorf("open failed: %v", err)
// 正确的包装方式（保留错误链，支持errors.Is检查）
return nil, fmt.Errorf("open failed: %w", err)

如果用%v而非%w包装错误，errors.Is和os.IsNotExist都无法识别原始错误，这时候就会出现“抓不到”的情况。

总结一下，处理os调用中“文件不存在”错误的惯用流程：

• 对于直接从os包方法返回的错误，优先用os.IsNotExist判断；
• 对于可能被包装过的错误，用errors.Is(err, os.ErrNotExist)来检查；
• 包装错误时始终用%w占位符保留原始错误链，确保后续错误检查能正常工作。

内容的提问来源于stack exchange，提问作者akshayc