Python批量创建文件夹的完整指南：从基础到最佳实践

本文详细讲解如何使用Python的os模块与pathlib模块安全、高效地批量创建指定名称的文件夹，深入解析常见TypeError错误的根源，并提供跨平台、可复用的企业级代码方案。

在Python自动化脚本开发与数据管理工作中，经常需要根据预设的项目结构批量创建一系列标准目录（例如CSV、images、PNG等）。Python内置的os模块提供了os.makedirs()和os.path.exists()等核心函数来安全地完成这项任务。然而，许多初学者常因语法误解而遭遇报错——例如错误地在print()函数中使用path=关键字参数（print()并不接受此参数），或者未将目标文件夹名称与基础目录路径正确拼接，导致文件夹被创建在非预期的当前工作目录中。

下面，我们提供一个正确、健壮且易于扩展的Python代码实现方案，帮助你彻底解决这些问题：

import os

# ✅ 定义需要创建的文件夹名称列表（注意：名称中不应包含路径分隔符）
folder_names = ['CSV', 'images', 'PNG']

# ✅ 指定父目录（基础路径）
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)  # 使用os.path.join安全拼接路径，确保跨系统兼容性
    if not os.path.exists(full_path):
        os.makedirs(full_path)
        print(f"✅ 文件夹创建成功：{full_path}")
    else:
        print(f"⚠️  文件夹已存在，跳过创建：{full_path}")

理解这段代码中的关键要点，对于编写可靠的Python文件管理脚本至关重要：

• os.path.join()是实现跨平台路径拼接的标准方法。它能自动适配不同操作系统（Windows、Linux、macOS）的路径分隔符（“\”或“/”），彻底避免因手动拼接字符串而引发的兼容性问题。
• 需要特别注意：os.path.exists()的path参数是位置参数。这意味着你不能将其写为`path=xxx`的关键字参数形式。这种写法仅适用于函数签名中明确定义了该关键字的函数。例如，较新版本的os.makedirs(path=…)可能支持，但print()函数完全不接受，误用会直接触发TypeError: ‘path’ is an invalid keyword argument for print()。
• os.makedirs()具备递归创建嵌套目录的能力（例如“data/CSV/raw”）。如果仅需创建单层目录，且希望更严格地控制创建过程，可以使用os.mkdir()，但必须确保其父目录已存在，否则会引发FileNotFoundError。
• 实践证明，在创建文件夹前始终使用os.path.exists()检查路径是否存在是一个优秀的编程习惯。这不仅能避免重复创建，还能有效预防潜在的FileExistsError异常，显著提升脚本的健壮性和容错能力。

当然，如果你追求更现代、更优雅的Pythonic写法，强烈推荐掌握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参数一步到位，等效于先检查存在性再创建

无论是使用经典的os模块还是现代的pathlib模块，其核心原则是相通的：明确路径的完整语义、避免硬编码路径分隔符、始终对目标路径进行存在性校验。掌握这一模式后，无论是进行数据预处理、日志归档，还是自动化项目初始化，你都能高效构建起稳定可靠的文件管理流程，从而大幅提升工作效率与代码质量。