os.mkdir只能创建单层目录且要求父目录存在,否则报FileNotFoundError;需用os.makedirs("a/b/c")递归创建,加exist_ok=True避免已存在时报错。

os.mkdir 创建单层文件夹失败的常见原因
直接调用 os.mkdir("a/b/c") 会报 FileNotFoundError,不是权限问题,而是它根本不处理路径中已不存在的父目录。它只建最末一级,且要求上级目录必须存在。
- 适用场景:你明确知道父目录已经存在,比如在临时目录下建一个子文件夹
- 错误现象:
FileNotFoundError: [Errno 2] No such file or directory: 'a/b/c' - 注意:
os.mkdir不接受exist_ok=True参数(那是os.makedirs的) - 如果父目录可能不存在,别硬扛,换
os.makedirs
os.makedirs 是多级创建的默认选择
os.makedirs 才是真正用来“递归建目录”的函数,它会一层层向上检查并创建所有缺失的中间目录。
- 基础用法:
os.makedirs("a/b/c")—— 自动创建a、a/b、a/b/c - 避免重复报错的关键参数:
exist_ok=True,即使目录已存在也不抛异常 - 不加
exist_ok=True时,若目录已存在会报FileExistsError - 性能上无明显差异,但比手动
os.path.exists+os.mkdir判断更简洁、更原子
Pathlib 的 mkdir 更现代,但要注意 parent 参数
Python 3.4+ 推荐用 pathlib.Path,语义更清晰,但默认行为和 os.mkdir 一样——只建最后一级。
- 错误写法:
Path("a/b/c").mkdir()→ 同样报FileNotFoundError - 正确写法:
Path("a/b/c").mkdir(parents=True, exist_ok=True) -
parents=True对应os.makedirs的递归逻辑;exist_ok=True避免已存在时报错 - 优势:路径拼接自然(
Path("a") / "b" / "c"),跨平台兼容性更好
Windows 下路径分隔符与反斜杠陷阱
在 Windows 上用字符串拼路径时,写 "a\b\c" 可能被解释成转义字符(比如 \b 是退格符),导致路径错乱或静默失败。
立即学习“Python免费学习笔记(深入)”;
- 不要手拼带反斜杠的字符串:
"a\b\c"是危险的 - 推荐方案:用正斜杠(Python 自动适配)
"a/b/c",或用os.path.join("a", "b", "c"),或用Path("a") / "b" / "c" - 验证路径是否合法:建完后用
Path("a/b/c").is_dir()确认,别只信没报错
exist_ok=True 不是默认值,而生产环境又常需要幂等创建**。漏掉它,第一次跑正常,第二次就崩——这种 bug 往往出现在部署脚本或初始化逻辑里,查起来费时间。










