文件与路径管理：使用os和pathlib模块进行文件、文件夹的创建、复制、移动、重命名、删除，以及批量处理文件路径和遍历目录树的实战方法

在Python办公自动化与数据统计实战中，文件与路径管理是最基础也最关键的技能之一。无论是读取Excel报表、整理CSV数据，还是归档每日生成的日志文件，都离不开对文件系统的高效操作。Python标准库提供了两个核心模块——os（含os.path）和pathlib，它们分别代表了传统字符串路径处理与现代面向对象路径处理的两种范式。本章将系统讲解这两个模块在文件、文件夹的创建、复制、移动、重命名、删除，以及批量路径处理和目录树遍历中的实战方法，帮助你在自动化脚本中构建稳健、可维护的文件操作层。

上图展示了os模块与pathlib模块在文件路径管理中的核心定位与互补关系。在实际开发中，os模块更偏向底层系统调用，而pathlib提供了更符合Python风格的面向对象接口。下面我们将从核心原理、操作流程、实战案例和常见误区四个维度展开详细讲解。

一、核心原理：os模块与pathlib模块的设计哲学

os模块是Python与操作系统交互的底层接口，它提供了访问文件系统、进程管理、环境变量等功能的函数集合。其中os.path子模块专门用于路径字符串的处理，它通过字符串拼接和解析来完成路径操作。这种设计在Python 3.4之前是唯一的标准方案，至今仍被大量旧代码和系统脚本使用。

pathlib模块是Python 3.4引入的面向对象路径处理库，它把路径抽象为Path对象，通过方法调用和运算符重载（如/）来实现路径操作。这种设计更符合现代Python的编程风格，代码可读性更强，且自动处理不同操作系统的路径分隔符差异。

从Python 3.6开始，官方推荐在新项目中使用pathlib，但os模块在系统级操作（如环境变量、进程管理）中仍然不可替代。在实际项目中，两者常常混合使用：用pathlib处理路径逻辑，用os模块执行系统级调用。

二、判断方法与操作流程：文件与文件夹的增删改查

在编写文件操作代码前，需要先明确操作对象是文件还是文件夹，以及目标路径是否存在。以下是标准化的操作流程：

1. 路径确认：使用Path.exists()或os.path.exists()判断目标路径是否存在。
2. 类型判断：使用Path.is_file()或Path.is_dir()确认是文件还是目录。
3. 创建操作：创建目录使用Path.mkdir(parents=True, exist_ok=True)，创建文件使用open()或Path.touch()。
4. 复制操作：Python标准库没有直接的复制函数，通常使用shutil.copy2()保留元数据。
5. 移动/重命名：使用Path.rename()或os.rename()，注意目标路径不能已存在。
6. 删除操作：删除文件用Path.unlink()，删除空目录用Path.rmdir()，删除非空目录用shutil.rmtree()。

三、案例拆解：批量整理下载文件夹中的报表文件

假设你有一个downloads文件夹，里面混杂着Excel报表（.xlsx）、CSV数据文件（.csv）、PDF报告（.pdf）和临时文件（.tmp）。你需要编写一个自动化脚本，将这些文件按扩展名分类到不同的子文件夹中，并给所有Excel文件添加日期前缀。

初始状态：downloads文件夹中有约200个文件，命名混乱，无统一规则。

目标：

• 创建excel、csv、pdf、temp四个子文件夹。
• 将对应扩展名的文件移动到对应文件夹。
• 将Excel文件重命名为20250115_原文件名.xlsx格式。

实现代码：

from pathlib import Path
import shutil
from datetime import datetime

# 定义源目录
source_dir = Path.home() / 'downloads'
# 定义分类映射
category_map = {
    '.xlsx': 'excel',
    '.xls': 'excel',
    '.csv': 'csv',
    '.pdf': 'pdf',
    '.tmp': 'temp'
}

# 获取当前日期作为前缀
date_prefix = datetime.now().strftime('%Y%m%d')

# 遍历源目录中的所有文件
for file_path in source_dir.iterdir():
    if file_path.is_file():
        # 获取扩展名并转为小写
        ext = file_path.suffix.lower()
        if ext in category_map:
            # 确定目标子文件夹
            target_dir = source_dir / category_map[ext]
            target_dir.mkdir(exist_ok=True)
            
            # 如果是Excel文件，添加日期前缀
            if ext in ['.xlsx', '.xls']:
                new_name = f"{date_prefix}_{file_path.name}"
                target_path = target_dir / new_name
            else:
                target_path = target_dir / file_path.name
            
            # 移动文件（如果目标已存在则跳过）
            if not target_path.exists():
                shutil.move(str(file_path), str(target_path))
                print(f"已移动: {file_path.name} -> {target_path}")
            else:
                print(f"跳过(已存在): {file_path.name}")
        else:
            print(f"未分类文件: {file_path.name}")

print("文件整理完成！")

执行结果：脚本运行后，downloads文件夹下生成了四个分类子文件夹，所有文件按类型归档，Excel文件带上了日期前缀。整个过程耗时不到1秒，相比手动整理节省了大量时间。

风险与复盘：在运行脚本前，建议先备份重要文件。脚本中使用了target_path.exists()检查来避免覆盖已有文件，这是一个关键的安全措施。如果遇到文件名冲突，脚本会跳过并提示，你可以根据提示手动处理冲突文件。

四、目录树遍历与批量路径处理

在处理嵌套目录结构时，os.walk()和Path.rglob()是两种最常用的遍历方法。os.walk()返回一个三元组（当前目录路径、子目录列表、文件列表），适合需要同时处理目录和文件的场景；Path.rglob()则通过模式匹配直接返回符合条件的文件路径，代码更简洁。

遍历目录树统计文件大小：

from pathlib import Path

def get_folder_size(folder_path):
    """递归计算文件夹总大小"""
    total_size = 0
    folder = Path(folder_path)
    for file_path in folder.rglob('*'):
        if file_path.is_file():
            total_size += file_path.stat().st_size
    return total_size

# 使用示例
size_bytes = get_folder_size('/path/to/project')
size_mb = size_bytes / (1024 * 1024)
print(f"项目总大小: {size_mb:.2f} MB")

批量修改文件扩展名：

from pathlib import Path

# 将所有.txt文件改为.md
for txt_file in Path('docs').rglob('*.txt'):
    new_path = txt_file.with_suffix('.md')
    txt_file.rename(new_path)
    print(f"重命名: {txt_file.name} -> {new_path.name}")

五、常见误区与总结复盘

在实际开发中，文件操作最容易出现以下几类问题：

• 路径分隔符硬编码：在Windows上使用'/'，在Linux上使用'\\'，导致跨平台兼容性问题。解决方案是使用pathlib自动处理，或使用os.path.join()。
• 忽略文件存在性检查：直接执行重命名或删除操作，导致FileNotFoundError或PermissionError。应在操作前使用exists()和is_file()进行判断。
• 误用删除操作：os.remove()只能删除文件，os.rmdir()只能删除空目录，删除非空目录必须使用shutil.rmtree()，且该操作不可恢复。
• 编码问题：在处理中文文件名时，建议使用pathlib，它默认使用Unicode编码，避免乱码问题。