如何在Python中自动创建多个文件夹

如何在Python中自动创建多个文件夹

本文介绍使用Python的os模块批量创建指定名称的文件夹，解决因误用关键字参数导致的TypeError错误，并提供健壮、可复用的代码实现。

在自动化文件管理任务中，经常需要根据项目结构预先创建一组标准目录（如 CSV、images、PNG 等）。Python 的 os 模块提供了 os.makedirs() 和 os.path.exists() 两个核心函数来安全地完成该任务。但初学者常因语法误解而报错——例如在 print() 函数中错误传入 path= 关键字参数（print() 不接受该参数），或未将目标路径与基础目录拼接，导致文件夹被创建在当前工作目录而非预期位置。

以下是一个正确、健壮且可扩展的实现方案：

import os

# ✅ 定义要创建的文件夹名称（注意：不带斜杠，保持命名规范）
folder_names = ['CSV', 'images', 'PNG']

# ✅ 指定父目录路径（即你所说的 'path'）
base_path = r"C:\your\project\root"  # Windows 示例；Linux/macOS 用 "/home/user/project"

# ✅ 遍历并逐个创建（含完整路径拼接）
for folder_name in folder_names:
    full_path = os.path.join(base_path, folder_name)  # 安全拼接路径，兼容各系统
    if not os.path.exists(full_path):
        os.makedirs(full_path)
        print(f"✅ 创建成功：{full_path}")
    else:
        print(f"⚠️  已存在：{full_path}")

那么，这段代码里有哪些关键要点需要把握呢？

• os.path.join() 是跨平台路径拼接的唯一推荐方式，它能自动处理不同操作系统的路径分隔符，彻底告别手动拼接“/”或“\”带来的兼容性噩梦。
• 需要警惕的是，os.path.exists() 的 path 参数是位置参数。这意味着你不能写成 path=xxx 的形式。这种写法只适用于那些明确支持该关键字的函数。比如，虽然较新版本的 os.makedirs(path=…) 可能支持，但 print() 函数是完全不接受的，误用就会触发 TypeError。
• os.makedirs() 可以递归创建嵌套目录（例如 “data/CSV/raw”）。如果只需要创建单层目录，并且希望对创建过程有更严格的控制，可以使用 os.mkdir()，但前提是必须确保其父目录已经存在。
• 经验表明，始终在创建前检查路径是否存在是一个好习惯。这不仅能避免重复操作，还能有效预防潜在的 FileExistsError 异常，让脚本更加健壮。

当然，如果你追求更现代、更优雅的写法，可以了解一下 pathlib 模块。它能将路径视为对象，让代码的可读性大幅提升。例如，实现按文件类型自动归类并创建文件夹：

立即学习“Python免费学习笔记（深入）”；

from pathlib import Path

base = Path(r"C:\your\project\root")
for name in ["CSV", "images", "PNG"]:
    (base / name).mkdir(exist_ok=True)  # exist_ok=True 参数一步到位，等效于 exists() 检查加 makedirs() 创建

话说回来，无论是使用经典的 os 模块还是现代的 pathlib，核心原则其实是一致的：明确路径的语义、避免硬编码路径分隔符、始终对路径的存在性进行校验。掌握这个模式，无论是数据预处理、日志归档，还是项目初始化，你都能高效地构建起可靠的自动化文件管理流程。这才是提升工作效率的关键所在。