Python 中复制并重命名文件的核心方法是使用 `shutil` 模块的 `copy2`（或 `copy`）函数。`copy2` 会尽可能复制文件的元数据，而 `copy` 仅复制内容。操作分为两步：首先复制文件到目标路径（包含新文件名），然后该路径即为重命名后的文件。有时需结合 `os.path` 来构造目标路径[ref_1][ref_2][ref_4][ref_6]。 根据不同应用场景，主要有以下几种方法： | 场景 | 核心函数 | 特点 | | :--- | :--- | :--- | | **基础单文件复制重命名** | `shutil.copy2(src, dst)` | 最常用，`dst`可包含完整新文件名和路径。 | | **批量文件复制重命名** | `os.listdir()` + 循环 + `shutil.copy2()` | 遍历源目录，在循环内为每个文件构造新名称。 | | **基于规则批量重命名** | 同上，但命名逻辑更复杂 | 例如按序号重命名（`001.jpg`, `002.jpg`）[ref_6]或从Excel读取规则[ref_1]。 | | **复制整个文件夹及其内容** | `shutil.copytree(src, dst)` | 递归复制整个目录树，`dst`为目标目录名，可实现文件夹级的“重命名”[ref_5]。 | ### 1. 基础单文件复制与重命名 此方法直接使用 `shutil.copy2(src, dst)`，其中 `dst` 参数指定为目标路径和新文件名。 ```python import shutil import os # 定义源文件路径 source_file = '/path/to/source/original_document.pdf' # 定义目标目录和新的文件名 target_directory = '/path/to/destination/' new_filename = 'renamed_document_v2.pdf' # 组合目标路径 destination_file = os.path.join(target_directory, new_filename) # 执行复制并重命名 shutil.copy2(source_file, destination_file) print(f"文件已复制并重命名为: {destination_file}") ``` 在这段代码中，`os.path.join` 用于安全地拼接路径，避免因操作系统不同导致的路径分隔符问题。`shutil.copy2(source_file, destination_file)` 执行了复制操作，由于 `destination_file` 包含了一个与源文件不同的名称，因此实现了复制并重命名[ref_4]。 ### 2. 批量复制并重命名文件 这是常见的自动化需求，例如处理一批图片或文档。需要遍历源目录中的所有文件，并为每个文件生成一个新的目标文件名[ref_2][ref_6]。 ```python import os import shutil def batch_copy_and_rename(source_dir, target_dir, prefix="file_"): """ 将源目录下的所有文件复制到目标目录，并按顺序重命名。 参数: source_dir: 源文件目录路径 target_dir: 目标目录路径 prefix: 新文件名的前缀 """ # 确保目标目录存在 os.makedirs(target_dir, exist_ok=True) # 获取源目录下所有文件名列表 file_list = os.listdir(source_dir) for index, filename in enumerate(file_list, start=1): # 构建完整的源文件路径 source_file_path = os.path.join(source_dir, filename) # 确保是文件而非文件夹 if os.path.isfile(source_file_path): # 分割文件名和扩展名 file_extension = os.path.splitext(filename)[1] # 构建新文件名，例如：file_001.jpg, file_002.png new_filename = f"{prefix}{index:03d}{file_extension}" # 构建完整的目标文件路径 destination_file_path = os.path.join(target_dir, new_filename) # 复制文件 shutil.copy2(source_file_path, destination_file_path) print(f"已复制: {filename} -> {new_filename}") ``` **应用示例**：假设有一个存放原始图片的文件夹 `./raw_images`，需要将其所有文件复制到 `./processed_images` 并按 `photo_001.jpg` 格式命名。 ```python batch_copy_and_rename('./raw_images', './processed_images', prefix='photo_') ``` 这段代码通过 `os.listdir()` 获取文件列表，循环中使用 `os.path.splitext()` 保留原扩展名，并用格式化字符串 `{index:03d}` 生成三位数字序号，从而实现结构化批量重命名[ref_2][ref_6]。 ### 3. 基于映射关系批量复制重命名文件夹 当重命名规则不是简单的序列，而是由一份对照表（如 CSV、Excel）决定时，需要先读取映射关系，再执行操作[ref_5]。 ```python import pandas as pd import shutil import os def batch_copy_rename_by_mapping(mapping_file, source_root, target_root): """ 根据映射文件（CSV）复制并重命名文件夹或文件。 映射文件需包含'old_name'和'new_name'两列。 参数: mapping_file: 映射表文件路径（CSV格式） source_root: 源文件夹根路径 target_root: 目标文件夹根路径 """ # 读取映射表 df = pd.read_csv(mapping_file) # 确保目标根目录存在 os.makedirs(target_root, exist_ok=True) for _, row in df.iterrows(): old_name = row['old_name'] new_name = row['new_name'] # 构建源路径和目标路径 src_path = os.path.join(source_root, old_name) dst_path = os.path.join(target_root, new_name) # 判断源路径是文件还是文件夹 if os.path.isdir(src_path): # 如果是文件夹，使用copytree复制整个目录 shutil.copytree(src_path, dst_path) print(f"已复制文件夹: {old_name} -> {new_name}") elif os.path.isfile(src_path): # 如果是文件，使用copy2复制 shutil.copy2(src_path, dst_path) print(f"已复制文件: {old_name} -> {new_name}") else: print(f"警告: 源路径不存在 {src_path}") ``` **应用场景**：在 GIS 或资产管理中，常有大量图斑或素材文件夹需要根据新旧编号对照表进行整理归档。此方法通过 `pandas` 读取映射关系，并使用 `os.path.isdir()` 判断对象类型，分别调用 `shutil.copytree()`（用于文件夹）或 `shutil.copy2()`（用于文件），从而实现了灵活的批量操作且不损坏源数据[ref_5]。 ### 4. 关键注意事项 1. **路径检查与创建**：在执行操作前，应使用 `os.path.exists()` 检查源路径是否存在，并使用 `os.makedirs(target_dir, exist_ok=True)` 确保目标目录存在，避免 `FileNotFoundError`[ref_2][ref_5]。 2. **文件与文件夹判断**：在批量处理时，使用 `os.path.isfile()` 和 `os.path.isdir()` 区分处理对象，防止将文件夹误当作文件复制导致错误。 3. **错误处理**：在实际脚本中应添加 `try-except` 块来捕获和处理可能出现的异常（如权限错误、磁盘空间不足等），增强脚本的鲁棒性。 4. **复制函数选择**： * `shutil.copy(src, dst)`: 仅复制文件内容。 * `shutil.copy2(src, dst)`: 复制内容及尽可能多的元数据（如修改时间）。 * `shutil.copytree(src, dst)`: 递归复制整个目录树[ref_5]。 综上所述，Python 通过 `shutil` 和 `os` 模块提供了强大的文件操作能力。根据需求选择合适的方法，从简单的单文件操作到基于复杂映射的批量文件夹处理，都能高效完成。核心在于准确构建源路径和目标路径，其中目标路径包含了重命名后的新名称。