在 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是否为空,避免把整个上级基准目录误删。
