Go os.RemoveAll 删除路径时为什么不报不存在错误

os.RemoveAll 删除一个已经不存在的文件或目录时返回 nil，不是漏报错误，而是为了让清理操作具备幂等性。真正需要关注的是：目录树可能只删除了一部分、权限或挂载状态可能让它返回 *os.PathError，所以不能因为“不存在不报错”就把所有清理错误都忽略。

不存在路径为什么返回 nil

RemoveAll 的语义是删除指定路径及其所有子项。官方文档明确规定：如果路径不存在，就返回 nil。这让“创建资源后无条件清理”可以重复执行，不需要先调用 os.Stat 再决定是否删除，也减少了检查与删除之间的竞态窗口。

因此，下面的判断通常已经足够：err == nil 表示清理目标已经达到“不再存在”的结果，可能是本次删除成功，也可能是它原本就不存在。不要把这个结果解读为“之前一定存在”。

package main

import (
    "fmt"
    "os"
)

func removeWorkspace(path string) error {
    // RemoveAll 对不存在路径返回 nil，适合做可重复的收尾动作。
    if err := os.RemoveAll(path); err != nil {
        return fmt.Errorf("清理 %s 失败: %w", path, err) // 保留底层错误供上层判断。
    }
    return nil // 目标已不存在，不需要把“未找到”当成失败。
}

func main() {
    fmt.Println(removeWorkspace("cache/old-run")) // 路径不存在时输出 nil。
}

nil 不代表所有删除过程都没有问题

删除一个目录树时，RemoveAll 会尽力删除能处理的内容；如果中途遇到权限不足、目录状态变化或底层文件系统错误，它会继续尝试其它部分，并返回最先遇到的错误。这个设计意味着调用方不能只看“部分文件已经消失”，还要把返回的 error 当成清理结果的一部分。

如果只是想知道错误是否属于标准的不存在语义，应使用 errors.Is(err, fs.ErrNotExist)，不要比较 err.Error()。不过对 RemoveAll 来说，根路径不存在的正常情况已经直接返回 nil；ErrNotExist 判断主要用于包装函数、组合多个文件系统操作或处理竞态下的底层错误。

func cleanup(path string) (err error) {
    err = os.RemoveAll(path)
    if err == nil {
        return nil // 目录已不存在，幂等清理完成。
    }

    var pathErr *os.PathError
    if errors.As(err, &pathErr) {
        // PathError 保留操作名、路径和底层原因，日志不要只留一段文本。
        return fmt.Errorf("操作=%s 路径=%s: %w", pathErr.Op, pathErr.Path, pathErr.Err)
    }
    return err // 自定义文件系统错误仍交给上层处理。
}

这里的重点不是把错误重新包装成一条更长的字符串，而是用 %w 保留错误链。这样上层仍可用 errors.Is 或 errors.As 判断权限、不存在和其它原因。

临时目录清理要保留主流程错误

最常见的场景是创建临时目录后用 defer 清理。清理失败时，应该记录清理错误；但如果主流程已经失败，不能让清理错误覆盖真正导致任务失败的原始错误。下面的写法用命名返回值把两类错误分开：只有主流程没有错误时，清理失败才成为最终返回值。

func withTempDir(work func(string) error) (err error) {
    dir, err := os.MkdirTemp("", "go-cleanup-")
    if err != nil {
        return fmt.Errorf("创建临时目录失败: %w", err) // 创建失败时没有可清理目录。
    }
    defer func() {
        removeErr := os.RemoveAll(dir)
        if removeErr != nil && err == nil {
            err = fmt.Errorf("清理临时目录失败: %w", removeErr) // 不覆盖已有业务错误。
        }
    }()

    if err = work(dir); err != nil {
        return fmt.Errorf("临时任务失败: %w", err) // 先保留主流程错误。
    }
    return nil
}

如果清理目标在业务代码中已经被提前删除，defer 再调用一次仍会得到 nil。这正是幂等语义的价值：收尾代码不必围绕“谁先删除”写复杂分支。

遇到错误时该怎样处理

不要为了“让清理成功”而吞掉所有错误，也不要为了确认路径存在而先做一次检查。对不存在路径，RemoveAll 已经给出了可重复调用的成功语义；对真实删除失败，则应保留错误链，让上层决定重试和告警。

常见问题

RemoveAll 和 Remove 有什么区别？

Remove 只删除文件或空目录；RemoveAll 会递归处理目录及其子项，并对不存在路径返回 nil。删除范围更大时要格外确认传入路径来自可信边界。

为什么不先用 os.Stat 判断目录是否存在？

先检查再删除会增加一次系统调用，而且检查结果可能在删除前失效。直接调用 RemoveAll 更符合幂等清理的语义，需要诊断时再记录删除返回的错误。

清理失败需要立刻重试吗？

不一定。先根据 PathError 的底层原因判断：权限问题需要修复运行用户或目录权限，I/O 或挂载问题需要观察基础设施，路径竞态则要确认是否仍有其它进程占用或创建内容。

参考资料：https://pkg.go.dev/os#RemoveAll；https://pkg.go.dev/errors#Is；https://pkg.go.dev/errors#As。