应使用 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 并释放资源，失败意味着数据可能未持久化。
- 所有显式调用
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)
}
真正难的不是写对一个 os.Open，而是想清楚：这个错误是该立刻返回、静默跳过、降级使用默认值，还是记录后继续？每种选择背后都是对业务语义的理解。文件系统行为本身就有不确定性，错误处理策略必须和你的可靠性要求对齐。 
