os.Remove仅删除单个文件或空目录，对非空目录报错；os.RemoveAll递归删除但无回滚，需校验路径安全；Windows下需重试处理文件占用问题。
os.Remove 删除单个文件或空目录失败的常见原因
直接调用 os.Remove 报错 "no such file or directory" 或 "directory not empty" 是最常遇到的问题。它只删「一个路径」，且不递归——如果传入的是非空目录，必然失败。
使用场景：清理临时生成的单个日志文件、配置备份、已知为空的缓存目录。
-
os.Remove对文件和空目录都有效，但对非空目录会返回syscall.ENOTEMPTY（Windows）或syscall.EBUSY（某些 Linux 文件系统挂载情况） - 路径必须是绝对路径或相对于当前工作目录的正确路径；
os.Remove("tmp/")和os.Remove("tmp")效果一致，末尾斜杠不影响判断 - 权限不足时返回
operation not permitted，尤其在 macOS 上对~/Library下某些目录、或 Windows 上被占用的文件
err := os.Remove("config.bak")
if err != nil {
// 注意：别只判 err == nil，要检查具体错误类型
if errors.Is(err, fs.ErrNotExist) {
log.Println("文件已不存在，跳过")
} else {
log.Fatal(err)
}
}os.RemoveAll 递归删除目录时的隐蔽风险
os.RemoveAll 看似“一劳永逸”，但它会无差别清空整个子树，一旦路径写错，后果不可逆——比如把 "." 或 "/tmp" 误传进去，可能删掉项目根目录甚至系统临时文件。
使用场景：清理构建产物目录（如 dist/）、测试生成的临时目录、CI 中的 workspace 清理。
立即学习“go语言免费学习笔记（深入）”；
- 它不会跳过只读文件（如 git 生成的
.git目录里的文件），但在 Windows 上可能因文件被进程占用而失败 - 删除过程中遇到任意子项失败（权限、占用、路径太长），就立即中止，已删的部分不会回滚
- 对符号链接本身操作：若
path是软链，os.RemoveAll删除的是链接本身，不是它指向的目标
// 危险！不要这样写
os.RemoveAll(".") // 当前目录全删
<p>// 安全做法：先确认路径、加前缀校验、或用 filepath.Abs 规范化
absPath, _ := filepath.Abs("build/")
if strings.HasSuffix(absPath, "/build") { // 简单防护，防误删父级
os.RemoveAll(absPath)
}删除前必须检查路径是否安全的三个动作
Go 没有内置的“模拟删除”或交互确认机制，所以所有删除操作都得靠代码提前兜底。光靠 os.Stat 不够，因为权限、挂载状态、符号链接深度都会影响最终结果。
- 用
filepath.EvalSymlinks展开路径，避免软链绕过校验（例如./tmp → /var/tmp） - 用
os.Stat+os.IsNotExist判断存在性，再用fi.Mode().IsDir()区分文件/目录类型，决定该用Remove还是RemoveAll - 对目录做“白名单父路径”检查：比如只允许删
$PWD/tmp下的东西，就用strings.HasPrefix(absPath, allowRoot)校验
abs, _ := filepath.Abs(target)
real, _ := filepath.EvalSymlinks(abs)
if !strings.HasPrefix(real, "/home/user/myapp/tmp") {
log.Fatal("拒绝删除越界路径：", real)
}
stat, err := os.Stat(real)
if err != nil {
log.Fatal(err)
}
if stat.IsDir() {
os.RemoveAll(real) // 目录走 RemoveAll
} else {
os.Remove(real) // 文件走 Remove
}Windows 下删除失败的特殊处理点
Windows 的文件锁机制比 Unix 更严格，即使文件只是被某个进程“打开过”，也可能导致 os.RemoveAll 卡在某个文件上并报 "Access is denied" 或 "The process cannot access the file because it is being used by another process"。
- 常见诱因：IDE（VS Code、GoLand）后台扫描、杀毒软件实时监控、终端仍在该目录下执行命令（比如
cd build && ls） - 没有通用的“强制解锁”API，可靠做法是重试 + 延迟：
time.Sleep(100 * time.Millisecond)后再试，最多 3 次 - 慎用
os.Chmod(path, 0666)去掉只读属性——对系统文件或 Git 仓库里的文件可能无效，还可能引发其他权限问题
for i := 0; i < 3; i++ {
err := os.RemoveAll(dir)
if err == nil {
break
}
if strings.Contains(err.Error(), "Access is denied") ||
strings.Contains(err.Error(), "being used by another process") {
time.Sleep(100 * time.Millisecond)
continue
}
log.Fatal(err)
}事情说清了就结束。真正麻烦的从来不是函数怎么调，而是删之前你根本不知道那个目录里有没有正在被写入的日志、有没有被 IDE 锁住的 .go 文件、或者某个路径其实是挂载的网络盘——这些没法靠 os.Remove 自己判断。
