Python用os.makedirs递归创建多级目录方法

本文深入剖析了Python中递归创建多级目录的核心要点与常见陷阱，指出`os.makedirs`失败往往并非路径书写错误，而是因父目录缺失且未设置`exist_ok=True`，或受权限、磁盘空间、跨平台兼容性（如Windows反斜杠转义、Linux umask影响）及不可信路径输入等深层因素干扰；文章强烈推荐采用更现代、类型安全、语义清晰的`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"a\b\c" 或正斜杠 "a/b/c" 更安全
• 若需设置权限（如 Linux），加上 mode=0o755，但注意 umask 会影响最终权限

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

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

使用场景差异：

• 老项目或需要兼容 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)</p>

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

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()) 校验（如果是服务端场景）。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~