最安全、最现代的做法是直接用pathlib.Path.mkdir(parents=True, exist_ok=True),它天然规避竞争条件、语义清晰、Python 3.5+稳定可用;而os.makedirs虽支持exist_ok=True,但在NFS等场景下行为不一致,且可能静默忽略权限错误或磁盘满等真实失败。

直接用 pathlib.Path.mkdir(parents=True, exist_ok=True),这是最安全、最现代的做法。 它天然规避竞争条件,语义清晰,且在 Python 3.5+ 中已稳定可用。老式 os.path.exists + os.makedirs 组合有竞态风险,不推荐新代码使用。
为什么 os.makedirs 加 exist_ok=True 还不够好?
它确实能避免 FileExistsError,但仍有两个隐性问题:
-
os.makedirs在部分旧系统(如某些 NFS 挂载点)上可能对exist_ok行为不一致,尤其当目录被快速删除又重建时 - 权限错误(
PermissionError)、磁盘满(OSErrorwitherrno.ENOSPC)等真实失败会被静默吞掉——你只看到“没报错”,但目录其实没建成功 - 它不检查父路径是否可写,仅检查最终路径是否存在;若中间某级是只读目录,
os.makedirs仍会抛异常,但错误信息不如pathlib明确
pathlib.Path.mkdir 的关键参数必须配齐
单独写 Path("a/b/c").mkdir() 会报 FileNotFoundError —— 因为默认不创建父目录。必须显式传参:
-
parents=True:逐级创建所有缺失的上级目录(类似mkdir -p) -
exist_ok=True:目录已存在时不报错;若设为False(默认),则FileExistsError必然触发 - 权限控制可选:
mode=0o755,但 Windows 上基本忽略该参数
示例:
立即学习“Python免费学习笔记(深入)”;
from pathlib import Path
Path("logs/error/2026/09").mkdir(parents=True, exist_ok=True)
遇到 PermissionError 怎么办?别急着加 sudo
常见于 Linux/macOS 下往系统路径(如 /var/log/myapp)写入,或 Windows 下往 C:\Program Files 写入。此时:
- 先确认目标路径的父目录是否可写:
Path("/var/log").exists()且os.access("/var/log", os.W_OK) - 不要捕获所有
Exception并吞掉——这会让真正的问题(比如路径含非法字符、设备离线)难以定位 - 若需降权运行,优先改用用户可写路径(如
~/.cache/myapp或Path.cwd() / "data"),而非硬扛权限问题
真正的难点不在“怎么写那行代码”,而在于明确「谁拥有这个路径」「它是否在容器或沙盒里」「父目录的 sticky bit 或 ACL 是否干扰创建」——这些环境细节,比函数选型更能决定成败。


















