Python3 os.makedirs() 方法（建议收藏）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 Python 开发中，文件和目录的管理是基础但重要的任务。无论是构建 Web 应用、处理日志，还是设计复杂的项目结构，开发者经常需要动态创建或删除目录。Python3 os.makedirs() 方法正是为此设计的核心工具之一。它能够高效、灵活地创建多级目录结构，适用于各种场景。本文将从基础概念到高级技巧，结合实例代码，帮助读者全面掌握这一方法的使用与原理。

一、os.makedirs() 方法的基础用法

1.1 方法简介

os.makedirs() 是 Python 标准库 os 模块中的一个函数，用于递归创建多级目录。与 os.mkdir() 不同，它能够一次性生成包含嵌套层级的目录路径，例如：

import os  
os.makedirs("parent/child/grandchild")  

这条代码会依次创建 parent、child 和 grandchild 三个层级的目录，而无需逐层调用 os.mkdir()。

1.2 对比单层目录创建方法

若使用 os.mkdir()，则需分步操作：

os.mkdir("parent")  
os.mkdir("parent/child")  
os.mkdir("parent/child/grandchild")  

显然，os.makedirs() 的效率和便捷性更高，尤其在处理复杂目录结构时优势显著。

1.3 基础语法与参数

方法的完整语法为：

os.makedirs(name, mode=0o777, exist_ok=False)  

• name：要创建的目录路径（字符串类型）。
• mode（可选）：目录权限模式，默认为 0o777（八进制表示）。
• exist_ok（可选）：布尔值，若为 True，则目录已存在时不抛出错误；默认为 False。

二、参数详解与进阶技巧

2.1 权限模式（mode 参数）

mode 参数控制新目录的访问权限，例如：

os.makedirs("secure_folder", mode=0o700)  # 仅所有者可读写执行  

权限值通过八进制数表示，常见的模式包括：
| 八进制值 | 权限说明 |
|----------|-------------------------|
| 0o777 | 所有用户均可读、写、执行 |
| 0o755 | 所有者可读写执行，其他用户只读执行 |
| 0o700 | 仅所有者拥有全部权限 |

比喻：权限模式就像给目录加了一把锁，不同的数字代表锁的类型，决定谁能打开它。

2.2 exist_ok 参数的陷阱与妙用

当目标目录已存在时，默认会抛出 FileExistsError。例如：

os.makedirs("existing_dir")  # 若目录存在，会报错  

此时，设置 exist_ok=True 可避免错误：

os.makedirs("existing_dir", exist_ok=True)  # 平静地忽略错误  

注意：此参数在批量创建目录时尤其有用，例如日志目录的初始化。

2.3 路径拼接与动态生成

实际开发中，目录路径常需动态生成，例如：

user_id = "1001"  
os.makedirs(f"user_{user_id}/documents/reports", exist_ok=True)  

通过字符串格式化或 os.path 模块，可灵活构建路径：

import os.path  
base_path = "/data"  
full_path = os.path.join(base_path, "year_2023", "month_09")  
os.makedirs(full_path, exist_ok=True)  

三、实际案例与代码示例

3.1 案例 1：用户文件夹管理

假设需要为每个用户创建独立的文件夹结构：

def create_user_folders(users):  
    for user in users:  
        user_dir = f"users/{user}/downloads"  
        os.makedirs(user_dir, exist_ok=True)  
        print(f"成功创建用户 {user} 的下载目录")  

users_list = ["alice", "bob", "charlie"]  
create_user_folders(users_list)  

此代码为每个用户生成 users/[用户名]/downloads 目录，并自动忽略已存在的路径。

3.2 案例 2：日志目录的按天创建

在日志系统中，按日期生成目录：

import datetime  

today = datetime.datetime.now().strftime("%Y-%m-%d")  
log_dir = f"logs/{today}"  
os.makedirs(log_dir, exist_ok=True)  
print(f"日志目录 {log_dir} 已就绪")  

此案例结合时间戳动态生成路径，确保每日日志存储在独立目录中。

四、常见问题与解决方案

4.1 路径错误导致目录未创建

问题：输入路径格式错误（如反斜杠 \ 在 Windows 系统中需转义）。
解决方案：

os.makedirs("C:\my_folder\new_dir")  # 反斜杠可能被解释为转义字符  

os.makedirs(r"C:\my_folder\new_dir")  # 原始字符串避免转义  
或者  
os.makedirs("C:/my_folder/new_dir")  # 使用正斜杠兼容性更好  

4.2 权限不足导致创建失败

问题：程序无权在指定路径下创建目录。
解决方案：

• 检查运行程序的用户是否有写入权限。
• 使用 try-except 捕获异常并提示：

try:  
    os.makedirs("/protected_dir", mode=0o700)  
except PermissionError:  
    print("无权限创建该目录，请检查权限设置")  

4.3 避免递归创建的意外覆盖

问题：若路径中包含已有文件而非目录，os.makedirs() 会报错。
解决方案：

if not os.path.exists(target_dir) or not os.path.isdir(target_dir):  
    os.makedirs(target_dir, exist_ok=True)  

五、与 os 模块其他方法的协同使用

5.1 结合 os.path.exists() 判断路径

if not os.path.exists("temp"):  
    os.makedirs("temp")  
else:  
    print("目录已存在")  

5.2 递归删除目录的对比

删除目录时，可使用 shutil.rmtree() 配合 os.makedirs()：

import shutil  

try:  
    shutil.rmtree("old_dir")  # 递归删除旧目录  
except FileNotFoundError:  
    pass  
os.makedirs("old_dir/new_subdir")  # 重建新结构  

六、总结与延伸

Python3 os.makedirs() 方法是开发者高效管理文件系统的利器，尤其适合需要动态创建多级目录的场景。通过理解其参数细节（如 mode 和 exist_ok），开发者可以灵活控制目录的权限和行为。结合实际案例，例如用户文件夹管理或日志系统，能进一步体现其实用性。

对于进阶开发者，可探索以下方向：

1. 结合 tempfile 模块生成临时目录。
2. 在多线程/分布式环境中处理目录竞争条件。
3. 使用 pathlib 模块的 Path.mkdir() 替代 os.makedirs()（Python 3.5+）。

掌握这一方法后，开发者可以更从容地应对复杂项目中的文件组织需求，提升代码的健壮性和可维护性。