Python os.mkdir() 方法（快速上手）

Python os.mkdir() 方法详解：从零开始创建目录

在日常开发中，我们经常需要动态创建文件夹来组织项目数据、日志文件、临时缓存等内容。Python 提供了 os.mkdir() 方法，专门用于在系统中创建单个目录。对于初学者来说，这个方法看似简单，但背后涉及的路径处理、异常管理、权限控制等细节，往往容易踩坑。本文将带你系统掌握 Python os.mkdir() 方法的使用技巧，通过真实案例和代码演示，让你真正“用得对、用得稳”。

什么是 Python os.mkdir() 方法？

os.mkdir() 是 Python 标准库 os 模块中的一个函数，它的作用是在当前工作目录或指定路径下创建一个新目录。它的语法非常简洁：

os.mkdir(path, mode=0o777)

• path：要创建的目录路径，可以是相对路径（如 data/backup）或绝对路径（如 /home/user/data/backup）。
• mode：目录的权限模式，默认是 0o777，表示所有用户都有读、写、执行权限。这个参数在 Windows 系统上通常被忽略。

💡 小贴士：0o777 中的 o 表示八进制数。你可以理解为：7 = 读 + 写 + 执行，0o777 意味着所有者、组和其他用户都有完整权限。

想象一下，os.mkdir() 就像你手中的一把“建房钥匙”——它能帮你从无到有地建起一座小房子（目录），但前提是地基（父目录）必须存在。

基本用法：创建一个简单目录

我们先从最基础的用法开始。假设你想在当前项目目录下创建一个叫 logs 的文件夹，用来存放程序运行日志。

import os

os.mkdir("logs")

print("目录 'logs' 创建成功！")

✅ 注意：这段代码执行前，logs 目录必须不存在。如果已经存在，会抛出 FileExistsError 错误。
❗关键点：os.mkdir() 只能创建单层目录，不能自动创建多级路径。

实际场景：日志目录创建

import os

log_dir = "logs"

if not os.path.exists(log_dir):
    os.mkdir(log_dir)
    print(f"✅ 成功创建目录: {log_dir}")
else:
    print(f"ℹ️  目录已存在: {log_dir}")

这段代码更实用：先判断目录是否存在，再创建。这是项目中常见的安全操作，避免因重复创建导致异常。

多级目录创建：os.makedirs() 是更好的选择

虽然 os.mkdir() 只能创建单层目录，但如果你需要创建 data/2024/04/15 这样的多级目录结构，os.mkdir() 会报错，因为它会尝试创建 data 目录，但 data 不存在，所以无法继续。

这时，你应该使用 os.makedirs() 方法，它能自动创建所有缺失的父目录。

import os

path = "data/2024/04/15"

os.makedirs(path, exist_ok=True)

print(f"✅ 目录路径 {path} 已成功创建")

✅ exist_ok=True 参数表示：如果目录已存在，不报错，直接跳过。这是非常推荐的做法，避免程序中断。

常见错误与解决方案

错误 1：FileExistsError - 目录已存在

import os

try:
    os.mkdir("test_dir")
except FileExistsError:
    print("❌ 目录已存在，无法重复创建")

🛠 解决方法：使用 os.path.exists() 检查，或使用 os.makedirs(path, exist_ok=True)。

错误 2：PermissionError - 权限不足

当你尝试在系统保护目录（如 /usr/bin）创建目录时，会遇到权限错误。

import os

try:
    os.mkdir("/usr/bin/myapp")
except PermissionError:
    print("❌ 权限不足，无法在该路径创建目录")

📌 建议：始终在用户可写目录下创建目录，如当前项目目录、~/Documents 等。

错误 3：路径格式错误（Windows 反斜杠问题）

在 Windows 系统中，路径使用反斜杠 \，但 Python 字符串中 \ 是转义符。

os.mkdir("C:\data\backup")

os.mkdir("C:/data/backup")
os.mkdir(r"C:\data\backup")  # r 表示原始字符串，忽略转义

✅ 推荐使用正斜杠 /，因为 Python 会自动适配系统路径分隔符。

实用案例：自动化项目结构生成器

我们来写一个实用的小工具：根据项目需求，自动生成标准目录结构。

import os

def create_project_structure(project_name):
    """
    创建一个标准项目目录结构
    项目结构：
    project_name/
    ├── data/
    │   ├── raw/
    │   └── processed/
    ├── notebooks/
    ├── scripts/
    └── logs/
    """
    # 根目录
    root_dir = project_name
    if not os.path.exists(root_dir):
        os.mkdir(root_dir)
        print(f"📁 创建项目根目录: {root_dir}")
    else:
        print(f"ℹ️  项目根目录已存在: {root_dir}")

    # 子目录列表
    subdirs = [
        "data/raw",
        "data/processed",
        "notebooks",
        "scripts",
        "logs"
    ]

    for subdir in subdirs:
        full_path = os.path.join(root_dir, subdir)
        # 使用 makedirs 自动创建父目录
        os.makedirs(full_path, exist_ok=True)
        print(f"📁 创建子目录: {full_path}")

    print("🎉 项目结构创建完成！")

create_project_structure("my_ml_project")

✅ 运行后会在当前目录生成 my_ml_project 文件夹，并自动创建所有子目录。
✅ 代码中使用了 os.path.join()，它能自动适配不同系统的路径分隔符，非常健壮。

最佳实践总结

1. 优先使用 os.makedirs(path, exist_ok=True)：它更安全，支持多级创建，且不会因目录存在而报错。
2. 避免硬编码路径：使用 os.path.join() 拼接路径，确保跨平台兼容。
3. 使用 os.path.exists() 做前置判断：在不确定目录是否存在时，先检查再创建。
4. 捕获异常：使用 try-except 捕获 FileExistsError、PermissionError 等常见错误，提升程序健壮性。
5. 权限管理：不要在系统目录创建文件，确保程序有写入权限。

小结：掌握 Python os.mkdir() 方法的关键

Python os.mkdir() 方法 虽然功能单一，却是文件系统操作的基石。它教会我们：创建目录不是“一步到位”的事，而是一个需要判断、处理异常、考虑路径兼容性的过程。

从单层目录的创建，到多级目录的自动化生成，再到错误处理与最佳实践，我们一步步把一个简单的函数用得游刃有余。对于初学者，掌握它意味着你迈出了“真正操作文件系统”的第一步；对于中级开发者，它提醒你：哪怕是一个小功能，也要考虑边界情况和可维护性。

记住：一个好程序，不在于它多复杂，而在于它能在各种意外情况下依然稳定运行。而 os.mkdir() 正是你构建这种稳定程序的第一块砖。