创建文件夹

skypiea

os模块是 Python 与操作系统交互的核心工具，其中os.mkdir()和os.makedirs()是创建文件夹的基础函数，两者适用于不同的层级创建需求，是新手入门的首选。

1. 单级文件夹创建：os.mkdir ()
os.mkdir()（make directory）用于创建单级文件夹，即只能创建路径中的最后一级目录，要求上级目录必须存在，否则会抛出FileNotFoundError异常。
import os

# 定义要创建的文件夹路径（以当前工作目录下的test_dir为例）
folder_path = "test_dir"

# 检查文件夹是否已存在，避免重复创建报错
if not os.path.exists(folder_path):
    os.mkdir(folder_path)
    print(f"文件夹 {folder_path} 创建成功")
else:
    print(f"文件夹 {folder_path} 已存在，无需重复创建")
   
2. 多级文件夹创建：os.makedirs ()
当需要创建嵌套的多级文件夹时，os.makedirs()（make directories）是更合适的选择，该函数支持一次性创建路径中的所有不存在的上级目录，无需手动逐层创建。
import os

# 定义多级文件夹路径
multi_folder_path = "data/result/2026/02"

# 创建多级文件夹，同时添加exist_ok=True避免重复创建报错
os.makedirs(multi_folder_path, exist_ok=True)
print(f"多级文件夹 {multi_folder_path} 创建成功")
这里的exist_ok=True是核心参数 —— 设置该参数后，即使目标文件夹已存在，程序也不会抛出异常，替代了手动的os.path.exists()检查，让代码更简洁。若不设置该参数，重复创建时仍会触发FileExistsError。

使用 pathlib 模块创建文件夹
1. 单级 / 多级文件夹创建：Path.mkdir ()
pathlib模块的Path类整合了单级和多级文件夹的创建功能，通过parents参数控制是否创建上级目录，无需区分不同函数，逻辑更统一。
from pathlib import Path

# 1. 创建单级文件夹
single_dir = Path("new_test_dir")
if not single_dir.exists():
    single_dir.mkdir()
    print("单级文件夹创建成功")

# 2. 创建多级文件夹（设置parents=True）
multi_dir = Path("project/src/utils")
# parents=True：自动创建不存在的上级目录；exist_ok=True：避免重复创建报错
multi_dir.mkdir(parents=True, exist_ok=True)
print("多级文件夹创建成功")