os.Remove 删除非空目录会返回“directory not empty”错误;常见错误还包括“no such file or directory”“permission denied”“is a directory”。

os.Remove 只能删除空目录和普通文件,不能递归删非空目录;想安全删文件或整个目录树,得组合 os.RemoveAll 或手动遍历处理。
os.Remove 会报什么错?常见错误场景有哪些
os.Remove 失败时通常返回 *os.PathError,核心错误信息集中在 Err 字段。最常遇到的几种:
-
no such file or directory:路径不存在(注意:不是权限问题) -
permission denied:Linux/macOS 下无写权限,Windows 下文件被占用或只读 -
directory not empty:试图用os.Remove删非空目录(这是合法但失败的操作) -
is a directory:传入的是目录路径,但函数只接受文件或空目录
判断是否真“不存在”,别只看错误字符串,用 errors.Is(err, os.ErrNotExist) 更可靠。
os.Remove 和 os.RemoveAll 的关键区别
两者签名一样,但行为完全不同:
立即学习“go语言免费学习笔记(深入)”;
-
os.Remove(path string) error:仅删单个条目。若path是空目录,成功;若非空目录或文件被占用,失败。 -
os.RemoveAll(path string) error:递归删除——不管是不是空目录、有没有子项,只要路径存在且可访问,就全清掉(类似 shell 的rm -rf)。
⚠️ 注意:os.RemoveAll 不会提示确认,也没有回收站。误传 "/" 或 "." 可能导致项目/系统级误删。
安全删除文件的推荐写法(带存在性检查)
直接调 os.Remove 容易 panic 或掩盖真实意图。建议先用 os.Stat 检查路径状态:
fi, err := os.Stat("/tmp/data.txt")
if err != nil {
if errors.Is(err, os.ErrNotExist) {
fmt.Println("文件不存在,无需删除")
return
}
log.Fatal(err)
}
if !fi.Mode().IsRegular() {
log.Fatal("不是普通文件,拒绝删除")
}
if err := os.Remove("/tmp/data.txt"); err != nil {
log.Fatal(err)
}
这种写法明确表达了「只删普通文件」的语义,也避免了对目录或设备文件等误操作。
删目录前必须确保它是空的?不一定
如果目标是删一个已知结构的目录(比如缓存目录),又不想用 os.RemoveAll 那么激进,可以手动清空再删:
dir := "/tmp/my-cache"
entries, err := os.ReadDir(dir)
if err != nil {
log.Fatal(err)
}
for _, ent := range entries {
os.RemoveAll(filepath.Join(dir, ent.Name())) // 递归删每个子项
}
os.Remove(dir) // 此时目录为空,Remove 才成功
不过多数场景下,直接用 os.RemoveAll 更简洁。真正需要分步控制的,通常是调试、日志归档或权限敏感路径(如用户家目录下的配置目录)。
最易被忽略的一点:Windows 下,如果文件正被另一个进程以不支持共享的方式打开(比如记事本没关),os.Remove 会直接失败,且无法通过重试绕过——必须先释放句柄。跨平台代码里,这类错误要单独兜底处理,不能只依赖 time.Sleep 等待。










