17370845950

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 消解，必须人工干预修复路径结构。