Go 文件操作需始终检查 error,安全做法包括:打开后立即判错、defer 延迟关闭、显式检查 Close() 错误、避免重复关闭、写入时检查 Write/Flush 错误。

在 Go 中处理文件操作错误,核心是始终检查 os 包函数返回的 error 值,不能忽略。安全打开和关闭文件的关键在于:及时判断错误、使用 defer 配合 Close()、避免重复关闭、并在出错时合理清理。
打开文件时必须检查 error
调用 os.Open、os.Create、os.OpenFile 等函数后,error 不为 nil 表示操作失败(如文件不存在、权限不足、路径无效等),此时不应继续使用返回的 *os.File。
- 不要写
f, _ := os.Open("x.txt")—— 忽略 error 是常见且危险的习惯 - 应写成:
f, err := os.Open("x.txt")
if err != nil {
log.Fatal("打开文件失败:", err)
}
defer f.Close() - 若需区分错误类型(如“文件不存在”),可用
errors.Is(err, os.ErrNotExist)判断
用 defer 关闭文件,但要注意执行时机
defer f.Close() 是惯用写法,它确保函数退出前关闭文件,但有两点要注意:
-
defer在函数 return 后才执行,如果后续代码 panic 或提前 return,仍能保证关闭 -
Close()本身也可能返回 error(如写入缓冲区失败),尤其在写文件时建议显式检查:err := f.Close()
if err != nil {
log.Println("关闭文件时出错:", err)
} - 避免对同一文件多次调用
Close()—— 第二次会返回ErrClosed,虽不崩溃但属逻辑错误
写文件时优先用 os.Create 或 os.OpenFile 并检查写入错误
仅检查打开是否成功不够,Write、WriteString、fmt.Fprintln 等也返回 error,磁盘满、中断、只读挂载等情况都会导致写失败。
立即学习“go语言免费学习笔记(深入)”;
- 正确示例:
f, err := os.Create("out.txt")
if err != nil {
log.Fatal(err)
}
defer f.Close()
n, err := f.WriteString("hello")
if err != nil {
log.Fatal("写入失败:", err)
}
fmt.Printf("写入 %d 字节\n", n) - 使用
bufio.Writer时,别忘了最后调用Flush()并检查其 error —— 缓冲内容可能尚未落盘
需要手动控制关闭时机?用 if + 显式 Close
当文件需在函数中途关闭(例如读到特定内容就退出),或需根据条件决定是否关闭时,避免 defer,改用显式关闭并再次检查 error:
f, err := os.Open("data.txt")
if err != nil {
return err
}
defer func() {
if closeErr := f.Close(); closeErr != nil {
log.Printf("关闭时出错: %v", closeErr)
}
}()
// ... 处理逻辑
if shouldStopEarly {
return nil // defer 仍会执行 Close
}- 若已手动调用过
f.Close(),再 defer 就会导致 double-close;此时应去掉 defer,只保留一次显式关闭










