必须检查os.Open返回的error,因Go无异常机制,忽略会导致panic或逻辑错误;需用if err != nil判断,且用errors.Is(err, fs.ErrNotExist)区分错误类型。

判断 os.Open 是否失败必须检查返回的 error
Go 不支持异常机制,所有 IO 错误都通过返回的 error 值显式传递。忽略它等于默认文件一定存在、可读、权限正确——这在生产环境几乎从不成立。
常见错误现象:程序 panic 或静默跳过后续逻辑,因为 file 是 nil 但没被发现。
- 永远用
if err != nil检查os.Open、os.Create、ioutil.ReadFile(已弃用)等函数的error返回值 - 不要只检查
file == nil:即使打开失败,file可能非nil(比如部分初始化成功),但调用其方法会 panic - 使用
errors.Is(err, fs.ErrNotExist)区分「文件不存在」和「权限不足」等具体原因,便于差异化处理
file, err := os.Open("config.json")
if err != nil {
if errors.Is(err, fs.ErrNotExist) {
log.Fatal("配置文件丢失,请检查路径")
}
log.Fatal("打开文件失败:", err)
}
defer file.Close()
io.ReadFull 和 io.ReadAtLeast 的错误语义容易误判
这两个函数不是简单包装 Read,它们对「读取字节数不足」有明确的错误约定,直接和 io.EOF 混淆会导致逻辑错误。
-
io.ReadFull要求**必须读满**指定字节数,少一个字节就返回io.ErrUnexpectedEOF,而不是io.EOF -
io.ReadAtLeast要求**至少读到**指定字节数,若底层返回io.EOF且已读够,则不报错;若不够,才返回io.ErrShortBuffer - 别用
errors.Is(err, io.EOF)判断ReadFull是否失败——它根本不会返回io.EOF
buf := make([]byte, 1024)
n, err := io.ReadFull(file, buf)
if err != nil {
if errors.Is(err, io.ErrUnexpectedEOF) {
// 文件比预期短,可能是损坏或截断
log.Printf("读取不完整,仅读到 %d 字节", n)
} else {
log.Println("读取失败:", err)
}
}
关闭文件时的错误常被忽视但可能关键
file.Close() 可能返回错误,尤其在写入场景下:缓冲区 flush 失败、磁盘满、NFS 连接中断等,都会在此刻暴露。忽略它等于放弃最后的数据一致性校验机会。
10分钟内自己学会PHP其中,第1篇为入门篇,主要包括了解PHP、PHP开发环境搭建、PHP开发基础、PHP流程控制语句、函数、字符串操作、正则表达式、PHP数组、PHP与Web页面交互、日期和时间等内容;第2篇为提高篇,主要包括MySQL数据库设计、PHP操作MySQL数据库、Cookie和Session、图形图像处理技术、文件和目录处理技术、面向对象、PDO数据库抽象层、程序调试与错误处理、A
立即学习“go语言免费学习笔记(深入)”;
- 写入后
Close()报错,意味着数据可能未落盘,不能认为写入成功 - 不要把
defer file.Close()当作“一定会执行且无害”的保险——它仍可能失败,且defer不捕获错误 - 写操作推荐模式:
Write→Close→ 检查两个错误;或改用os.WriteFile(原子写,自动处理 close)
f, _ := os.Create("output.txt")
_, err := f.Write([]byte("hello"))
if err != nil {
log.Fatal("写入失败:", err)
}
err = f.Close() // 必须检查
if err != nil {
log.Fatal("关闭失败(数据可能未保存):", err)
}
跨平台路径和权限错误的兼容性陷阱
Windows 和 Unix-like 系统对路径分隔符、权限掩码、特殊文件(如 /dev/null)的处理差异极大,硬编码路径或忽略 os.PathSeparator 会导致运行时错误。
- 用
filepath.Join("dir", "sub", "file.txt")替代字符串拼接,避免"dir/sub/file.txt"在 Windows 下失效 -
os.MkdirAll(path, 0755)中的权限掩码在 Windows 上被忽略,但错误地设为0644可能导致目录不可遍历 - 检查
os.IsPermission(err)和os.IsNotExist(err),而非依赖错误字符串匹配
复杂点在于:有些错误(如 symlink 循环、too many open files)无法靠重试解决,需提前限流或换用更健壮的库(如 golang.org/x/exp/io/fs 的封装)。真正难的不是写 if err != nil,而是读懂 err 背后系统层的真实约束。









