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"a\b\c"或正斜杠"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()) 校验（如果是服务端场景）。
