Python怎么创建多级目录_os.makedirs递归创建深层级文件夹

os.makedirs 创建多级目录失败主因是父目录缺失且未设 exist_ok=true，或权限/磁盘问题；推荐优先使用 pathlib.path.mkdir(parents=true, exist_ok=true)，更现代且类型安全。

os.makedirs 创建多级目录失败报错 FileNotFoundError

根本原因不是路径写错了，而是父目录不存在且 exist_ok 参数没设对，或者权限/磁盘空间等底层问题被掩盖。默认情况下 os.makedirs 确实支持递归创建，但 python 3.2+ 才默认开启 exist_ok=False 的严格检查——如果目标目录已存在，就会直接抛 FileExistsError，而不是静默跳过。

常见错误现象：FileNotFoundError: [errno 2] No such file or Directory: 'a/b/c/d'，其实是因为中间某一级（比如 b）的父目录 a 根本没建，而你又没加 exist_ok=True 或没处理异常。

• 务必显式传 exist_ok=True，避免已存在时崩溃（尤其在脚本重复运行时）
• 路径必须是字符串，不能是 pathlib.Path 对象（除非你用的是 pathlib.Path.mkdir(parents=True, exist_ok=True)）
• windows 下注意反斜杠转义：用原始字符串 r"abc" 或正斜杠 "a/b/c" 更安全
• 若需设置权限（如 linux），加上 mode=0o755，但注意 umask 会影响最终权限

os.makedirs 和 pathlib.Path.mkdir 哪个更推荐

优先用 pathlib.Path.mkdir，它更现代、语义清晰，且天然支持链式调用和类型提示。但要注意：它默认不递归，必须显式写 parents=True，否则遇到中间缺级就报错。

使用场景差异：

立即学习“Python免费学习笔记（深入）”；

• 老项目或需要兼容 Python os.makedirs
• 新项目、配置文件路径拼接频繁、要配合 Path 其他方法（如 .joinpath()、.resolve()）→ 用 pathlib.Path.mkdir
• 需要原子性判断+创建（比如“仅当不存在时才建”）→ exist_ok=True 是必选项，两者都支持

示例对比：

import os os.makedirs("logs/error/2024/06", exist_ok=True) <p>from pathlib import Path Path("logs/error/2024/06").mkdir(parents=True, exist_ok=True)

权限和跨平台兼容性容易被忽略的点

os.makedirs 在 Windows 上基本不校验 mode，设了也无效；Linux/macos 则受 umask 影响，mode=0o755 实际可能变成 0o750。更麻烦的是 NFS 或容器挂载卷，有时会拒绝设置权限，导致后续写入失败但创建成功——表面看没问题，实际卡在下一步。

• 不要依赖 mode 控制最终权限，用 os.chmod 单独补设更可靠
• 路径中含中文或空格？确保终端/ide 编码为 UTF-8，Python 文件开头加 # -*- coding: utf-8 -*-（虽然现代 Python 默认 utf-8，但某些旧环境仍需）
• 绝对路径建议用 Path.cwd().joinpath("relative/path") 拼，别手写 "./a/b"，避免当前工作目录变动导致意外

创建失败后怎么快速定位哪一级出问题

别靠肉眼数斜杠。用循环逐级检查最稳：

from pathlib import Path p = Path("a/b/c/d") for parent in p.parents:     if not parent.exists():         print(f"缺失父目录：{parent}")         break

或者直接用 os.path.dirname 倒推：

• os.path.dirname("a/b/c/d") → "a/b/c"
• 再套一层 → "a/b"，直到返回空字符串或根路径
• 配合 os.path.exists 就能定位断裂点

真正难搞的不是语法，是路径来源不可控——比如用户输入、配置文件读取、http 参数拼接，这些地方一旦混入 ../ 或空字符，os.makedirs 会照单全收并尝试创建危险路径。所以，创建前务必做 Path.resolve().is_relative_to(Path.cwd()) 校验（如果是服务端场景）。