pathlib.Path.mkdir() 的 parents 参数控制父目录创建行为：parents=False（默认）仅建末级目录，任一父级缺失即报错；parents=True 逐级创建所有缺失父目录，已存在者自动跳过；exist_ok=True 仅避免目标目录已存在时报错。
pathlib.Path.mkdir() 的 parents 参数控制父目录创建行为
默认情况下，Path.mkdir() 不会创建不存在的父目录，遇到路径中某一级不存在就会报 FileNotFoundError。要让它“只在必要时创建父目录”，关键不是避免创建，而是精准控制 parents 和 exist_ok 的组合逻辑。
所谓“只在必要时”，实际是指：当目标路径的父级已存在，就只建最后一级；当父级缺失，才逐级向上创建——这正是 parents=True 的本意，而非“智能跳过”。它不会预判哪些父目录已经存在，而是按需补全整个路径链。
-
parents=False（默认）：仅尝试创建最末一级目录；若上级任一环节不存在，直接失败 -
parents=True：从根开始，逐级检查并创建所有缺失的中间目录 -
exist_ok=True：若目标目录已存在，不报错（否则抛FileExistsError）
如何避免重复创建已存在的父目录
pathlib 本身不提供“跳过已存在父目录”的开关，但 parents=True 在内部已做了存在性检查——它只会对不存在的路径段调用 os.mkdir()，不会重复创建已有目录。所以你不需要手动遍历父路径判断。
常见误操作是先用 path.parent.exists() 做判断再决定是否设 parents=True，这反而引入竞态条件和冗余逻辑。
- ✅ 正确做法：统一用
path.mkdir(parents=True, exist_ok=True) - ❌ 错误做法：先
if not path.parent.exists(): path.parent.mkdir(parents=True)，再path.mkdir() - ⚠️ 注意：
exist_ok=True只影响最终目标目录，不影响中间父目录的创建逻辑（中间目录仍按需新建，且不允许同名文件存在）
递归创建时遇到 PermissionError 怎么办
如果某一级父目录存在但权限不足（比如只读），mkdir(parents=True) 仍会尝试在其下创建子目录，从而触发 PermissionError。此时 pathlib 不会跳过该层，也不会静默忽略。
- 错误信息典型为：
PermissionError: [Errno 13] Permission denied: '/path/to/parent' - 这意味着
/path/to/parent目录存在但无写权限，无法在其内创建下一级 - 解决方案只能是提前校验关键父目录的写权限：
os.access(path.parent, os.W_OK)，或捕获异常后提示用户 - 不能依赖
exist_ok或parents参数绕过权限检查
与 os.makedirs() 的行为差异要点
pathlib.Path.mkdir(parents=True) 底层调用的就是 os.makedirs()，行为几乎一致，但有两处易忽略的细节：
-
os.makedirs()默认exist_ok=False，而 pathlib 在 Python 3.7+ 后也支持该参数，但老版本不支持，需注意兼容性 -
pathlib对路径对象做类型检查更严格：传入字符串会报TypeError，必须是Path实例；os.makedirs()接受字符串路径 - 两者都遵循系统级权限和文件系统限制，比如 Windows 下路径长度、保留名（CON、AUX 等）问题同样会触发
OSError
真正容易被忽略的是：即使设置了 parents=True，如果路径中某一级是个普通文件（而非目录），依然会报 NotADirectoryError——这个错误不会被 exist_ok 消解，必须人工干预修复路径结构。
