Python os.mkdir() 方法（一文讲透）

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 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 服务、处理数据，还是开发桌面应用，开发者常常需要动态创建、删除或操作目录结构。此时，Python os.mkdir() 方法便成为了一个不可或缺的工具。本文将从基础到进阶，系统讲解这一方法的使用场景、参数细节、常见问题及最佳实践，帮助开发者高效完成目录操作。

一、os 模块与目录操作简介

在 Python 中，os 模块是与操作系统交互的核心工具，提供了大量与文件系统相关的函数。目录操作作为其中的基础功能，os.mkdir() 是创建单层目录的直接方法。

1.1 文件系统与目录的类比

可以将文件系统想象为一个大型的文件柜，每个文件或目录对应一个抽屉。os.mkdir() 的作用类似于在文件柜中新增一个抽屉，而抽屉的地址（路径）和权限设置（如读写权限）则由开发者指定。

1.2 相关方法概览

除了 os.mkdir()，os 模块还提供了其他目录操作方法，如：

• os.makedirs()：递归创建多级目录（类似 mkdir -p 命令）。
• os.rmdir()：删除空目录。
• os.listdir()：列出目录内容。

这些方法共同构成了 Python 对文件系统的操作体系。

二、os.mkdir() 方法详解

2.1 基本语法与参数说明

os.mkdir() 的标准语法为：

os.mkdir(path, mode=0o777)  

• path：必需参数，表示要创建的目录路径（字符串类型）。
• mode：可选参数，默认值为 0o777（八进制表示），用于设置目录的权限模式（权限值需结合操作系统理解）。

参数 mode 的含义

权限模式 mode 的二进制位表示为 rwxrwxrwx，分别对应用户（User）、组（Group）、其他（Others）的读（r）、写（w）、执行（x）权限。例如：

• 0o755 表示用户有全部权限（7 = 4+2+1），组和其他用户有读和执行权限（5 = 4+1）。

注意：在 Windows 系统中，mode 参数通常被忽略，因为其文件系统不支持 Unix 风格的权限模式。

2.2 基础用法示例

案例 1：创建单层目录

import os  

os.mkdir("new_folder")  
print("目录创建成功！")  

运行后，当前目录下将生成一个名为 new_folder 的文件夹。

案例 2：指定权限模式

os.mkdir("secure_folder", mode=0o700)  

三、进阶用法与常见场景

3.1 创建嵌套目录的挑战

os.mkdir() 只能创建单层目录，若路径包含多级目录（如 parent/child/grandchild），则会抛出 FileNotFoundError。此时需使用 os.makedirs()：

os.makedirs("parent/child/grandchild")  # 递归创建所有层级目录  

3.2 动态路径拼接

实际开发中，路径可能动态生成。可通过 os.path 模块组合路径：

import os.path  

base_dir = "/data/projects"  
project_name = "my_app"  
full_path = os.path.join(base_dir, project_name)  
os.mkdir(full_path)  

3.3 异常处理与防御性编程

在创建目录前，建议检查路径是否存在或可写，以避免错误：

import os  

target_dir = "existing_folder"  
if not os.path.exists(target_dir):  
    os.mkdir(target_dir)  
else:  
    print(f"目录 {target_dir} 已存在！")  

四、常见问题与解决方案

4.1 路径无效或权限不足

问题：若路径无效（如包含非法字符）或权限不足，会抛出 PermissionError。
解决方案：

1. 使用绝对路径或验证相对路径的正确性。
2. 检查当前用户的权限（例如在 Linux 中使用 sudo）。

4.2 跨平台兼容性

问题：Windows 和 Unix 系统的路径分隔符不同（\ vs /）。
解决方案：

• 使用 os.path.join() 自动适配系统。
• 在代码中避免硬编码路径分隔符。

4.3 目录创建后的验证

创建目录后，可通过 os.path.isdir() 验证是否成功：

if os.path.isdir("new_folder"):  
    print("目录创建成功")  
else:  
    print("创建失败，请检查路径和权限")  

五、与其他方法的对比

5.1 os.mkdir() vs os.makedirs()

5.2 处理现有目录的冲突

若尝试创建已存在的目录，os.mkdir() 会报错。此时可结合 exist_ok 参数（需使用 os.makedirs()）：

os.makedirs("existing_dir", exist_ok=True)  # 若存在不报错  

六、实战案例：构建项目目录结构

假设需为一个 Web 项目创建以下目录结构：

project_root/  
├── static/  
│   ├── css/  
│   └── js/  
└── templates/  

通过 os.makedirs() 可高效实现：

import os  

base = "project_root"  
dirs = [  
    os.path.join(base, "static/css"),  
    os.path.join(base, "static/js"),  
    os.path.join(base, "templates")  
]  

for d in dirs:  
    os.makedirs(d, exist_ok=True)  

print("项目目录初始化完成！")  

七、性能与最佳实践

7.1 性能优化建议

• 批量操作：优先使用 os.makedirs() 替代多次 os.mkdir()，减少系统调用次数。
• 路径缓存：对高频操作的路径进行缓存，避免重复计算。

7.2 安全与权限管理

• 在多用户环境中，避免使用 mode=0o777（全权限），推荐 0o755 或更低权限。
• 避免在用户输入的路径中直接拼接，防止路径遍历攻击（如 ../）。

结论

Python os.mkdir() 方法是开发者管理文件系统的基础工具，其简洁的语法和强大的功能使其成为构建动态目录结构的核心手段。通过结合 os.path 模块、异常处理及跨平台适配，开发者可高效实现复杂场景下的目录操作。掌握这一方法不仅能提升代码的健壮性，还能为处理更高级的文件系统任务（如日志管理、数据持久化）打下坚实基础。

建议读者通过实际项目练习，例如搭建自动化脚本或开发文件管理工具，进一步巩固对 os.mkdir() 的理解。随着经验的积累，结合其他 os 模块函数，开发者将能更灵活地应对各类文件系统挑战。