Python如何批量复制文件

使用Python批量复制文件的方法包括使用shutil模块、os模块和路径库pathlib模块，推荐使用shutil模块，因为它提供了高层次的文件操作接口、简单易用、功能强大。

详细描述：shutil模块不仅能完成文件的复制操作，还能处理文件的移动、删除等多种文件操作。它提供的shutil.copy和shutil.copy2函数可以轻松地将文件从一个目录复制到另一个目录。shutil.copy只复制文件内容，而shutil.copy2还能复制文件的元数据如时间戳。

一、使用shutil模块批量复制文件

shutil模块是Python标准库中的一个模块，专门用于高级文件操作。使用shutil模块可以方便地进行文件复制、移动、删除等操作。以下是使用shutil模块批量复制文件的具体方法：

单文件复制

要复制单个文件，可以使用shutil.copy或shutil.copy2函数。shutil.copy函数只复制文件的内容，而shutil.copy2函数则会连同文件的元数据（如修改时间、权限等）一起复制。示例如下：

import shutil
源文件路径
src_file = 'path/to/source/file.txt'
目标文件路径
dst_file = 'path/to/destination/file.txt'
复制文件
shutil.copy(src_file, dst_file)
或者使用shutil.copy2
shutil.copy2(src_file, dst_file)

批量文件复制

如果要批量复制文件，可以使用循环遍历源目录中的所有文件，然后依次调用shutil.copy或shutil.copy2函数进行复制。示例如下：

import shutil
import os
源目录
src_dir = 'path/to/source/directory'
目标目录
dst_dir = 'path/to/destination/directory'
获取源目录中的所有文件
file_list = os.listdir(src_dir)
遍历并复制文件
for file_name in file_list:
    src_file = os.path.join(src_dir, file_name)
    dst_file = os.path.join(dst_dir, file_name)
    shutil.copy(src_file, dst_file)

如果要复制整个目录，可以使用shutil.copytree函数。该函数会递归地复制源目录及其所有内容到目标目录。示例如下：

import shutil
源目录
src_dir = 'path/to/source/directory'
目标目录
dst_dir = 'path/to/destination/directory'
复制目录
shutil.copytree(src_dir, dst_dir)

二、使用os模块批量复制文件

os模块是Python标准库中的另一个模块，专门用于操作系统级别的操作。虽然os模块没有提供直接的文件复制函数，但可以结合os模块的文件操作函数和shutil模块的shutil.copy函数来实现批量复制文件。示例如下：

单文件复制

import os
import shutil
源文件路径
src_file = 'path/to/source/file.txt'
目标文件路径
dst_file = 'path/to/destination/file.txt'
复制文件
shutil.copy(src_file, dst_file)

批量文件复制

import os
import shutil
源目录
src_dir = 'path/to/source/directory'
目标目录
dst_dir = 'path/to/destination/directory'
获取源目录中的所有文件
file_list = os.listdir(src_dir)
遍历并复制文件
for file_name in file_list:
    src_file = os.path.join(src_dir, file_name)
    dst_file = os.path.join(dst_dir, file_name)
    shutil.copy(src_file, dst_file)

三、使用pathlib模块批量复制文件

pathlib模块是Python 3.4版本引入的一个模块，提供了面向对象的文件系统路径操作接口。与os模块相比，pathlib模块的接口更加直观、易用。以下是使用pathlib模块批量复制文件的方法：

单文件复制

from pathlib import Path
import shutil
源文件路径
src_file = Path('path/to/source/file.txt')
目标文件路径
dst_file = Path('path/to/destination/file.txt')
复制文件
shutil.copy(src_file, dst_file)

批量文件复制

from pathlib import Path
import shutil
源目录
src_dir = Path('path/to/source/directory')
目标目录
dst_dir = Path('path/to/destination/directory')
获取源目录中的所有文件
file_list = src_dir.iterdir()
遍历并复制文件
for src_file in file_list:
    dst_file = dst_dir / src_file.name
    shutil.copy(src_file, dst_file)

四、批量复制文件时的注意事项

在批量复制文件时，需要注意以下几点：

在复制文件之前，需要确保目标目录存在。如果目标目录不存在，可以使用os模块的os.makedirs函数或pathlib模块的Path.mkdir方法来创建目标目录。示例如下：

import os
目标目录路径
dst_dir = 'path/to/destination/directory'
创建目标目录
os.makedirs(dst_dir, exist_ok=True)

或

from pathlib import Path
目标目录路径
dst_dir = Path('path/to/destination/directory')
创建目标目录
dst_dir.mkdir(parents=True, exist_ok=True)

文件覆盖

在复制文件时，如果目标目录中已经存在同名文件，默认情况下会覆盖目标文件。如果不希望覆盖目标文件，可以在复制文件之前检查目标文件是否存在，并根据需要处理。示例如下：

import os
import shutil
源文件路径
src_file = 'path/to/source/file.txt'
目标文件路径
dst_file = 'path/to/destination/file.txt'
检查目标文件是否存在
if not os.path.exists(dst_file):
    # 复制文件
    shutil.copy(src_file, dst_file)
else:
    print(f"File {dst_file} already exists.")

错误处理

在批量复制文件时，可能会遇到各种错误，如文件不存在、权限不足等。为了确保程序的健壮性，需要进行适当的错误处理。可以使用try-except语句捕获并处理可能的异常。示例如下：

import os
import shutil
源目录
src_dir = 'path/to/source/directory'
目标目录
dst_dir = 'path/to/destination/directory'
获取源目录中的所有文件
file_list = os.listdir(src_dir)
遍历并复制文件
for file_name in file_list:
    src_file = os.path.join(src_dir, file_name)
    dst_file = os.path.join(dst_dir, file_name)
    try:
        shutil.copy(src_file, dst_file)
    except Exception as e:
        print(f"Error copying {src_file} to {dst_file}: {e}")

五、示例代码

以下是一个综合示例，演示了使用shutil模块批量复制文件的完整过程，包括目标目录的创建、文件覆盖检查和错误处理：

import os
import shutil
from pathlib import Path
def batch_copy_files(src_dir, dst_dir):
    # 创建目标目录
    dst_dir = Path(dst_dir)
    dst_dir.mkdir(parents=True, exist_ok=True)
    # 获取源目录中的所有文件
    src_dir = Path(src_dir)
    file_list = src_dir.iterdir()
    # 遍历并复制文件
    for src_file in file_list:
        dst_file = dst_dir / src_file.name
        try:
            if not dst_file.exists():
                shutil.copy(src_file, dst_file)
            else:
                print(f"File {dst_file} already exists.")
        except Exception as e:
            print(f"Error copying {src_file} to {dst_file}: {e}")
示例调用
src_dir = 'path/to/source/directory'
dst_dir = 'path/to/destination/directory'
batch_copy_files(src_dir, dst_dir)