Go 删除文件夹

在 Go 语言中,删除文件夹(目录)主要分为 2 种情况。如果是里面没有任何内容的 “空文件夹”,我们可以直接使用 os.Remove() 函数删除。如果是装有文件或子目录的 “非空文件夹”,则需要使用 os 包的 os.RemoveAll() 函数进行递归删除。

小伙伴们可以把这两个删除函数,和 os.Mkdir()、os.MkdirAll() 对照起来记:只处理单层目标的函数名不带 “All” 后缀,而需要深入多层目录递归处理的函数名末尾都带有 “All” 后缀。

os.Remove() 删除空文件夹

在删除文件时我们已经用过 os.Remove() 函数,其实它也可以用来删除一个空文件夹。

语法:

err := os.Remove(name)

说明:

os.Remove() 接收目标文件夹的路径字符串 name 作为参数,并返回一个 error 错误值。如果传入的文件夹在硬盘上不存在,它会返回 os.ErrNotExist 错误。

为了防止误删里面的文件,os.Remove() 设有一道保护限制。只有当目标文件夹完全为空时,它才会将其删除并返回 nil。只要文件夹里还装有任何文件或子目录,它就会拒绝删除并返回目录非空的错误。

下面我们在工作目录下准备两个测试文件夹来对比效果:一个是空的 empty_dir 文件夹,另一个是里面放有 a.txt 文件的非空文件夹 busy_dir。

示例 1:删除空文件夹

package main

import (
    "fmt"
    "os"
)

func main() {
    // 1. 删除空文件夹 empty_dir
    err := os.Remove("empty_dir")
    if err != nil {
        fmt.Printf("删除空文件夹失败:%v\n", err)
    } else {
        fmt.Println("空文件夹 empty_dir 删除成功")
    }

    // 2. 尝试删除非空文件夹 busy_dir
    err = os.Remove("busy_dir")
    if err != nil {
        fmt.Printf("删除非空文件夹失败:%v\n", err)
    }
}

运行结果如下。

空文件夹 empty_dir 删除成功
删除非空文件夹失败:remove busy_dir: directory not empty

分析:

从运行结果可以看出,empty_dir 里面没有任何内容,我们调用 os.Remove("empty_dir") 就能顺利把它删掉。而 busy_dir 里面装有 a.txt 文件,调用 os.Remove("busy_dir") 时就会直接报错 directory not empty,提示该目录不是空的。

小伙伴在本地测试时要留意:第 1 次跑通这段代码后,empty_dir 已经被删掉了。如果紧接着直接运行第 2 次,第 1 步就会提示找不到目录。

如果我们想要把 busy_dir 连同它里面的文件一次性全部删掉,又应该怎么做呢?这时就需要使用下面介绍的 os.RemoveAll() 函数了。

os.RemoveAll() 递归删除文件夹

在 Go 语言中,我们可以使用 os.RemoveAll() 函数一次性递归删除整个文件夹,以及它内部包含的所有子文件和子文件夹。

语法:

err := os.RemoveAll(path)

说明:

os.RemoveAll() 接收目标路径字符串 path 作为参数。它会从最里层的子文件开始由内向外逐层清理,最后把最外层的目标文件夹本身也一并删除。

与 os.Remove() 不同的是,如果传入的目标路径本来就不存在,os.RemoveAll() 不会报错,而是直接返回 nil。哪怕传入的是单个普通文件的路径,它同样可以正常删除。接下来我们直接拿刚才没删掉的非空文件夹 busy_dir 来测试一下。

示例 2:递归删除非空文件夹

package main

import (
    "fmt"
    "os"
)

func main() {
    // 递归删除非空文件夹 busy_dir
    err := os.RemoveAll("busy_dir")
    if err != nil {
        fmt.Println("删除失败:", err)
        return
    }
    fmt.Println("非空文件夹 busy_dir 已全部删除")

    // 对已不存在的路径再次调用
    err = os.RemoveAll("busy_dir")
    if err == nil {
        fmt.Println("路径不存在时调用也不会报错")
    }
}

运行结果如下。

非空文件夹 busy_dir 已全部删除
路径不存在时调用也不会报错

分析:

os.RemoveAll("busy_dir") 表示递归清理整个 busy_dir 目录。程序会先把里面的 a.txt 以及可能存在的各级子文件夹删掉,最后再把最外层的 busy_dir 文件夹本身删掉。

清理完成后,我们紧接着对已经不存在的 busy_dir 再次调用 os.RemoveAll(),返回结果依然是 nil。这样就省去了删除前先调用 os.Stat() 检查目录是否存在的步骤,非常适合用来清理项目的临时缓存目录。

注意:

  • 永久清除无法找回:os.RemoveAll() 相当于 Linux 系统下的 rm -rf 命令,执行后会永久清空目录内容且不进回收站。小伙伴们调用前一定要仔细核对 path,千万不要误传根目录 "/"、当前目录 "." 或重要代码目录。
  • 拼接路径前先判空:如果目标路径是通过变量拼接出来的(如 filepath.Join(baseDir, subDir)),记得先检查 subDir 是否为空,避免把整个上级基准目录误删。

上一篇:

下一篇:

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号