17370845950

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

在 Go 语言中删除文件或目录，主要依靠 os 包提供的 Remove 和 RemoveAll 函数。它们用途不同，误用可能导致意外行为（比如删错目录、静默失败），下面直接讲清楚怎么用、有什么区别、以及常见注意事项。

删除单个文件或空目录：用 os.Remove

os.Remove 用于删除一个路径——它能删文件，也能删空目录。如果目标是**非空目录**，调用会返回 not empty 类型的错误（具体是 syscall.ENOTEMPTY 或平台相关错误），不会递归删除内容。

基本用法：

• 传入绝对路径或相对路径（如 "./data.txt" 或 "/tmp/log"）
• 成功时返回 nil 错误；失败时需检查错误类型，不能忽略
• 不支持通配符，也不能批量删多个路径

示例：

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）

示例：

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 修改权限（需有足够权限），再删除；或提示用户手动处理。