Go中删除文件或目录应区分使用os.Remove(删单个文件或空目录,非空目录报错)和os.RemoveAll(递归删除整个目录树,路径不存在也不报错),并需校验路径安全性、类型及权限。

在 Go 语言中删除文件或目录,主要依靠 os 包提供的 Remove 和 RemoveAll 函数。它们用途不同,误用可能导致意外行为(比如删错目录、静默失败),下面直接讲清楚怎么用、有什么区别、以及常见注意事项。
删除单个文件或空目录:用 os.Remove
os.Remove 用于删除一个路径——它能删文件,也能删空目录。如果目标是**非空目录**,调用会返回 not empty 类型的错误(具体是 syscall.ENOTEMPTY 或平台相关错误),不会递归删除内容。
基本用法:
- 传入绝对路径或相对路径(如
"./data.txt"或"/tmp/log") - 成功时返回
nil错误;失败时需检查错误类型,不能忽略 - 不支持通配符,也不能批量删多个路径
示例:
立即学习“go语言免费学习笔记(深入)”;
err := os.Remove("config.json")
if err != nil {
if os.IsNotExist(err) {
log.Println("文件不存在,跳过删除")
} else {
log.Fatal("删除失败:", err)
}
} else {
log.Println("删除成功")
}
递归删除整个目录树:用 os.RemoveAll
os.RemoveAll 是 Remove 的“强力版”:它会递归删除指定路径及其所有子文件、子目录,无论是否为空。适合清理临时目录、缓存目录等场景。
注意点:
- 路径末尾的斜杠不影响行为(
"temp/"和"temp"效果一样) - 如果路径本身不存在,不会报错(返回
nil),这点和Remove一致 - 权限不足、正在被占用的文件会导致部分删除失败,函数返回具体错误(如
permission denied)
示例:
立即学习“go语言免费学习笔记(深入)”;
err := os.RemoveAll("./build")
if err != nil {
log.Printf("清理 build 目录失败:%v", err)
// 可选择继续执行,或中断流程
}
安全删除前的必要检查
直接调用 Remove 或 RemoveAll 有风险,尤其路径来自用户输入或配置时。建议加一层防护:
-
验证路径是否在允许范围内:比如限定只能删
./uploads/下的文件,避免传入"../../etc/passwd"类路径 -
确认目标类型:用
os.Stat判断是文件还是目录,再决定用哪个函数(例如只允许删文件,就提前拒绝目录路径) -
避免重复删除逻辑中的 panic:不要用
os.Remove(path)后直接log.Fatal,而是先判断错误是否可忽略(如IsNotExist)
简单校验示例:
fi, err := os.Stat(path)
if err != nil {
if os.IsNotExist(err) {
return // 无需处理
}
return err
}
if !fi.IsDir() && filepath.Base(path) == "safe-file.txt" {
return os.Remove(path)
}
return fmt.Errorf("不允许删除该路径")
跨平台与权限相关细节
Windows 和 Unix-like 系统对删除操作的限制略有不同:
- Windows 下,如果文件正被其他进程打开(如记事本打开着),
Remove会失败;Unix 下通常可以删,但后续无法写入原路径(句柄仍有效) - 目录权限:即使有写权限,若父目录不可执行(
x位),某些系统可能无法进入子目录完成递归删除 - 符号链接:默认情况下,
Remove和RemoveAll都只删链接本身,不碰目标文件(即不会解引用)
实际项目中,遇到权限问题时,可考虑先尝试 os.Chmod 修改权限(需有足够权限),再删除;或提示用户手动处理。










