如何在Python中递归创建不存在的多级目录_使用os.makedirs与exist_ok

有没有遇见过这种情况？调用 os.makedirs 创建目录，结果抛了个 FileExistsError，说那个目录已经存在了。很多初学者第一反应是“出 bug 了”，其实不然。这是它的默认设计——它只负责“创建新目录”，不负责“确保目录存在”。如果只是想“保证路径能用”，无论它原来有没有，都得显式加上 exist_ok=True。

核心要点解析

关于 exist_ok：别让它成了脚本的“定时冲击波”

默认行为下，os.makedirs('a/b/c') 如果发现 a/b/c 已经存在，会直接抛出 FileExistsError: [Errno 17] File exists: 'a/b/c'。这个场景在反复运行脚本，或者多个进程尝试并发创建同一路径时尤其常见。

怎么选？其实看场景：

• 需要严格校验“全新创建”：保持 exist_ok=False（默认），适合初始化某些必须从头新建的敏感目录。
• 只需确保目录可用：用 exist_ok=True，路径已存在时安静跳过。日志目录、缓存路径这类幂等操作，用它最省心。
• 注意一个版本限制：exist_ok 参数从 Python 3.2 才开始引入。如果你的项目还在用更老的版本（概率很小了，但万一碰上了），只能手动捕获异常再忽略。

mode 权限控制的“陷阱”：它只管最深那一层

很多人以为 os.makedirs('a/b/c', mode=0o700) 会把 a、b、c 三层目录的权限都设成 700。但实际上，它只对最末端的 c 生效。a 和 a/b 这些父目录，依然按系统的默认 umask 创建。结果就是：你设了 700，但 a/b/ 可能还是 755。

如果非要统一权限，有两个办法：要么自己遍历路径逐级设置，要么事后用 os.chmod 补全：

import os
os.makedirs('a/b/c', exist_ok=True)
for root, dirs, _ in os.walk('a'):
    for d in dirs:
        os.chmod(os.path.join(root, d), 0o700)

不过说实话，大多数场景不用这么较真——只要最终目录权限是正确的，中间路径的读权限通常不影响使用。

和 os.mkdir 的区别：一个能“生一串”，一个只生一个

os.mkdir 不能递归创建，也不支持 exist_ok。哪怕路径只差一级（比如 'a/b' 不存在而 'a' 存在），它也会报 FileNotFoundError。这时候就只能请 os.makedirs 出场了。

• os.mkdir('a/b') → 报错（因为 mkdir 不递归）
• os.makedirs('a/b') → 成功（自动创建 a 再建 b）
• os.makedirs('a/b', exist_ok=True) → 无论 a/b 是否存在都无事发生

别试图用 os.mkdir 加 try/except 来模拟递归——很容易漏掉中间层级，逻辑比直接用 os.makedirs 复杂得多，完全没有必要。

Windows 下的路径分隔符：一个容易“翻车”的细节

在 Windows 上，如果你手写路径字符串时用了单反斜杠（'a\b\c'），Python 会把它当成转义字符处理。\b 会变成退格符，\c 直接报 SyntaxError。正确的打开方式有三种：

• 用正斜杠：os.makedirs('a/b/c')（所有平台都兼容）
• 用原始字符串：os.makedirs(r'a\b\c')
• 用 os.path.join 拼接：os.makedirs(os.path.join('a', 'b', 'c'))

另外，os.makedirs 内部会自动处理路径分隔符的标准化，传入 'a/b/c' 在 Windows 下会生成 a\b\c 目录，不用手动转换。

值得特别注意的是：exist_ok=True 并不万能。它只忽略“已存在”这一种错误。如果磁盘满了、权限不够、路径里出现了非法字符，该抛的异常一个都不会少。

综合建议

总结下来就几点：日常开发中，直接养成用 os.makedirs(dir_path, exist_ok=True) 的习惯，能省掉很多不必要的异常捕获。 对于权限有特殊要求的场景，记得它只影响最深层目录，要补权限就得手动遍历。遇到 Windows 路径问题，优先用正斜杠或 os.path.join。把这些细节记牢了，目录创建这块基本就不会再出问题了。