Go中删除文件或目录需用os.Remove(删单个文件或空目录,非空目录报错)和os.RemoveAll(递归删整个目录树,路径不存在也不报错);建议删除前用os.Stat检查路径类型与存在性,并注意符号链接和跨平台行为。

在 Go 语言中删除文件或目录,主要依靠 os 包提供的 Remove 和 RemoveAll 两个函数。它们用途不同、行为有别,用错容易导致程序 panic 或误删内容。
os.Remove:删除单个文件或空目录
os.Remove 用于删除指定路径的文件,或**空的目录**。如果目标是**非空目录**,调用会返回 os.ErrInvalid(具体错误类型为 *os.PathError,底层 errno 通常是 ENOTEMPTY)。
使用时需注意:
- 路径必须存在,否则返回
os.ErrNotExist - 对非空目录调用会失败,不会递归删除其内容
- 权限不足时返回
os.ErrPermission
示例:
立即学习“go语言免费学习笔记(深入)”;
err := os.Remove("config.json")if err != nil {
log.Fatal(err)
}
os.RemoveAll:递归删除文件或整个目录树
os.RemoveAll 是更“强力”的删除方式:它会删除指定路径及其所有子目录和文件,无论是否为空。适合清理临时目录、缓存目录或测试生成的整个输出结构。
它的行为特点:
- 路径不存在时,不报错,直接返回
nil - 能安全删除空目录、单个文件、嵌套多层的非空目录
- 同样受文件系统权限限制;若某子项不可写/不可访问,删除会中断并返回对应错误
示例:
立即学习“go语言免费学习笔记(深入)”;
err := os.RemoveAll("build/")if err != nil {
log.Printf("清理 build 目录失败:%v", err)
}
删除前建议先检查路径类型和存在性
虽然 Remove 和 RemoveAll 本身会返回错误,但提前判断可让逻辑更清晰、提示更友好。
常用检查方式:
- 用
os.Stat获取文件信息,再通过fi.IsDir()判断是否为目录 - 用
errors.Is(err, os.ErrNotExist)区分“不存在”和其他错误 - 避免假设路径一定存在,尤其处理用户输入或配置路径时
例如:
fi, err := os.Stat("data/")if err != nil {
if errors.Is(err, os.ErrNotExist) {
log.Println("data/ 不存在,跳过删除")
return
}
log.Fatal(err)
}
if fi.IsDir() {
os.RemoveAll("data/") // 安全递归删目录
} else {
os.Remove("data/") // 单删文件
}
注意跨平台路径与符号链接行为
Go 的 os.Remove 和 RemoveAll 在 Windows/macOS/Linux 上语义一致,但要注意:
- 符号链接(symlink)本身会被删除,**不会跟随链接去删目标内容**
- 路径分隔符用
/即可(Go 内部自动适配),无需手动调用filepath.Join,但拼接路径时仍推荐使用它保证健壮性 - Windows 下删除正在被其他进程占用的文件会失败(
ERROR_SHARING_VIOLATION),需确保无句柄打开
安全拼接示例:
path := filepath.Join("temp", "cache.db")os.Remove(path)










