Path.mkdir() 默认不创建父目录会报错,因其 parents=False 仅建末级目录,父目录缺失即抛 FileNotFoundError;需设 parents=True 且 exist_ok=True 才安全。

为什么 Path.mkdir() 默认不创建父目录会报错
直接调用 Path.mkdir() 时,如果上级目录不存在,会抛出 FileNotFoundError。这不是 bug,而是默认行为:它只创建最后一级目录,不递归建父级。比如 Path("a/b/c").mkdir() 在 a 或 a/b 不存在时必然失败。
exist_ok 和 parents 必须同时设对才安全
关键参数只有两个:parents 控制是否递归创建父目录,exist_ok 控制路径已存在时是否静默跳过。漏掉任一个都可能出问题:
-
parents=False(默认)→ 父目录缺一个就报错 -
exist_ok=False(默认)→ 目录已存在时抛FileExistsError - 正确组合是:
parents=True, exist_ok=True
示例:
from pathlib import Path
Path("logs/2024/06/15").mkdir(parents=True, exist_ok=True)
和 os.makedirs() 的行为差异要注意
虽然 os.makedirs(path, exist_ok=True) 效果类似,但 pathlib 的 mkdir() 不继承父目录权限(Linux/macOS 下尤其明显)。默认新建目录权限是 0o777 & ~umask,但不会自动复制父目录的 setgid 或 sticky bit。如果需要严格权限控制,得手动补 mode 参数,比如:
立即学习“Python免费学习笔记(深入)”;
Path("shared/cache").mkdir(parents=True, exist_ok=True, mode=0o2775)
另外,pathlib 不支持 dir_fd 这类底层文件描述符操作,高并发场景下注意原子性边界。
Windows 下路径分隔符和保留名仍需手动过滤
pathlib 自动处理正斜杠/反斜杠转换,但不校验 Windows 保留名(如 CON、AUX、NUL)。如果路径片段含这些名字,mkdir() 仍会成功返回,但后续文件操作可能失败。建议在创建前做简单检查:
def is_windows_reserved(name):
return name.upper() in {"CON", "PRN", "AUX", "NUL", "COM1", "LPT1"}
if any(is_windows_reserved(p) for p in Path("some/path").parts):
raise ValueError("Windows reserved name detected")
这个检查不能省——pathlib 不管语义,只管路径字符串拼接和系统调用转发。


















