最稳的文件系统操作需直接使用os/shutil并明确函数边界：os.path.isdir()安全判目录，shutil.copy2()保留元数据，shutil.rmtree()递归删目录但需处理权限，os.walk()遍历时通过topdown控制修改顺序。
直接用 os 和 shutil 做文件系统操作，不封装、不抽象，就是最稳的落地方式——但必须清楚每个函数的边界和副作用，否则删错目录、覆盖文件、权限丢失都是分分钟的事。
判断路径存在且是目录，别只用 os.path.exists()
os.path.exists() 只告诉你“这个路径有没有”，但可能是文件也可能是目录。真正想确认“它是个可遍历的目录”，得组合判断：
-
os.path.isdir(path)才是安全的目录判定，它隐含了exists检查 -
os.path.isfile(path)同理，专用于文件，不推荐用exists+ 后缀判断 - 注意：符号链接默认不被
isdir或isfile认可，要判链接本身用os.path.islink()
import os
path = "/tmp/data"
if os.path.isdir(path):
print("可以安全调用 os.listdir()")
else:
print("不是目录，别硬上")
shutil.copy() 和 shutil.copy2() 的元数据差异很关键
复制文件时，默认 shutil.copy() 只保留内容和权限（mode），但不保留修改时间、访问时间、扩展属性等；而 shutil.copy2() 会尽可能复制所有元数据（包括 stat 信息）。
- 备份、归档场景必须用
shutil.copy2()，否则时间戳全变成当前时间，影响增量逻辑 - 跨文件系统复制时，
copy2仍可能丢部分扩展属性（如 SELinux context），需额外处理 - 如果目标路径已存在且是目录，两个函数都会报
IsADirectoryError，不是静默覆盖
import shutil
shutil.copy2("/src/report.txt", "/dst/report.txt") # 保留 mtime/atime递归删除非空目录，优先选 shutil.rmtree()，但要注意权限陷阱
os.rmdir() 只能删空目录，真要删整个项目构建产物或缓存目录，必须用 shutil.rmtree()。
立即学习“Python免费学习笔记（深入）”；
- 它默认忽略只读文件（比如 Git 生成的
.git/objects），靠内部的onerror回调处理 - Windows 下若遇到正在被占用的文件（如日志被 tail 占着），会直接抛
PermissionError，无法自动跳过 - 安全做法：加
ignore_errors=False（默认值），配合自定义onerror显式处理错误
import shutil
import os
<p>def handle_remove<em>error(func, path, </em>):
os.chmod(path, stat.S_IWRITE)
func(path)</p><p>shutil.rmtree("/tmp/build", onerror=handle_remove_error)
os.walk() 遍历时修改目录结构要小心 yield 顺序
os.walk() 是深度优先、自顶向下遍历，但如果你在循环里动态删子目录或重命名父目录，后续迭代行为不可靠。
- 想安全清理某类文件（如所有
*.pyc），用topdown=True（默认），并在进入子目录前先处理当前层文件 - 想批量重命名目录名，必须用
topdown=False，确保先处理叶子节点，再向上改父名，避免路径失效 -
dirs列表可原地修改（如dirs[:] = [d for d in dirs if not d.startswith('_')]），这是控制遍历范围的唯一合法方式
for root, dirs, files in os.walk(".", topdown=True):
for f in files:
if f.endswith(".log"):
os.remove(os.path.join(root, f))真正难的不是写对一行代码，而是理解 shutil.rmtree() 为什么删不掉某个目录，或者 os.path.isdir() 在容器里返回 False 却没报错——这时候得看挂载选项、UID 映射、procfs 权限，而不是再翻文档。
