Python文件复制案例如何拷贝文件

本文目录导读：

1. 文章标题：Python文件复制案例精讲：从基础Shutil到高级并发拷贝技巧
2. 目录导读

Python文件复制案例精讲：从基础Shutil到高级并发拷贝技巧

目录导读

1. 引言：为何文件复制是Python自动化基石
2. 基础篇：使用shutil模块（最推荐）
   • shutil.copy() 与 shutil.copy2() 的区别与代码案例
   • shutil.copyfile() 的严格用法
   • shutil.copytree() 递归复制整个目录
3. 进阶篇：手工实现拷贝 (I/O流与路径操作)
   • 使用 open() 和 read()/write() 手工实现
   • 逐块拷贝大文件（内存友好策略）
   • 使用 pathlib 进行现代路径处理
4. 高级篇：并发拷贝与错误处理
   • 使用 concurrent.futures 多线程加速批量拷贝
   • 常用错误捕获（权限不足、路径不存在、磁盘空间不足）
5. 问答环节（FAQ）
6. 总结与最佳实践

---

为何文件复制是Python自动化基石

在日常的运维、数据处理或桌面自动化中，文件复制是一个高频操作，无论是备份日志、分发配置文件，还是整理大量图片，Python以其简洁的语法和强大的标准库，成为实现文件复制任务的首选语言，本文将从最常用的 shutil 模块讲起，逐步深入到手工IO流操作、目录递归复制，再到并发场景下的高性能拷贝，并结合真实案例和错误处理,帮助您彻底掌握Python文件复制。

基础篇：使用shutil模块（最推荐）

Python内置的 shutil (shell utility) 模块是文件拷贝的“瑞士军刀”，它封装了底层的系统调用,提供了直观的复制接口。

案例：单个文件拷贝

import shutil
import os
# 源文件与目标路径
source = “E:＼＼data＼＼source_file.txt”
destination = “E:＼＼backup＼＼file_copy.txt“
# 使用 shutil.copy() 复制文件内容与权限
shutil.copy(source, destination)
print(f”文件已复制到 {destination}“)
# 使用 shutil.copy2() 复制内容、权限以及元数据（例如修改时间）
shutil.copy2(source, destination)
print（”副本带有原始元数据“)
# 使用 shutil.copyfile() 严格复制文件内容（目标必须可写入）
shutil.copyfile(source， destination)

关键区别：

• shutil.copy(): 复制文件内容和权限，如果目标是一个目录,则在该目录下创建同名文件。
• shutil.copy2(): 与 copy 类似，但额外尝试复制元数据（如时间戳）。
• shutil.copyfile(): 仅复制文件内容，不关心权限或元数据,且目标不能是目录。

案例：复制整个目录

import shutil
src_dir = “E:＼＼data＼＼project”
dest_dir = “E:＼＼backup＼＼project_copy”
# copytree 递归复制整个目录
shutil.copytree(src_dir, dest_dir)
print（”整个目录已递归复制“)

注意： dest_dir 必须不存在，否则会引发 FileExistsError。

进阶篇：手工实现拷贝 (I/O流与路径操作)

当需要精细控制拷贝过程（只复制文件的前N字节，或边复制边加密）时,可以手工实现。

手工复制小文件

with open(“source.txt”， “rb”) as src, open(“dest.txt”， “wb”) as dst:
    dst.write(src.read（))

这种写法一次性将整个文件读入内存,适合小文件。

逐块拷贝大文件（内存友好）

import os
def copy_large_file(src, dst, chunk_size=1024*1024): # 每次读1MB
    ”“”
    使用固定大小缓冲区复制大文件，避免内存溢出
    ”“”
    with open(src, “rb”) as fsrc:
        with open(dst, “wb”) as fdst:
            while True:
                chunk = fsrc.read(chunk_size)
                if not chunk:
                    break
                fdst.write(chunk)
# 使用 pathlib 构建路径
from pathlib import Path
src_path = Path(“C：/big_file.iso”)
dst_path = Path(“D：/backups/big_file.iso”)
copy_large_file(src_path, dst_path)

为什么逐块拷贝重要？ 当处理GB级别的文件时，一次性 read() 会消耗大量RAM；而逐块读取可以稳定控制内存水位线。

高级篇：并发拷贝与错误处理

多线程批量拷贝

假设有1000个小文件需要快速复制到另一个目录，单线程太慢,使用线程池可以显著提速。

import shutil
from concurrent.futures import ThreadPoolExecutor, as_completed
import os
def copy_file(src_file, dest_dir):
    “”“拷贝单个文件到目标目录”“”
    try:
        dest_path = os.path.join(dest_dir, os.path.basename(src_file))
        shutil.copy2(src_file, dest_path)
        return f”成功： {src_file}”
    except Exception as e:
        return f”失败： {src_file} - {e}“
def batch_copy(file_list, destination_folder):
    “”“并发拷贝多个文件”“”
    # 确保目标目录存在
    os.makedirs(destination_folder, exist_ok=True)
    with ThreadPoolExecutor(max_workers=8) as executor：
        # 提交所有任务
        futures = {executor.submit(copy_file, f, destination_folder): f for f in file_list}
        for future in as_completed(futures):
            result = future.result（)
            print（result)
# 使用示例
files_to_copy = [“f1.txt”， “f2.txt”， “f3.txt”] # 实际应为完整路径
batch_copy(files_to_copy, “E：/backup_batch”)

注意： 对于大量小文件（<1MB），线程池加速明显；但对于大文件，磁盘I/O可能成为瓶颈,线程数不宜设置过高。

错误处理策略

文件复制最常见的错误：

错误类型	原因	处理方式
FileNotFoundError	源文件不存在	拷贝前检查 os.path.exists()
PermissionError	无权限读取源或写入目标	使用 try-except 捕获并提升权限
OSError (磁盘满)	磁盘空间不足	拷贝前使用 shutil.disk_usage() 检查剩余空间

import shutil
import os
def safe_copy(src, dst):
    try:
        if not os.path.exists(src):
            raise FileNotFoundError(f“源文件 {src} 不存在”)
        # 检查磁盘空间（可选）
        free_space = shutil.disk_usage(os.path.dirname(dst)).free
        file_size = os.path.getsize(src)
        if free_space < file_size * 1.2: # 预留20%余量
            raise OSError(“目标磁盘空间不足”)
        shutil.copy2(src, dst)
        print（”复制成功“)
    except PermissionError:
        print（”权限不足，请以管理员身份运行“)
    except Exception as ex:
        print（f”复制异常: {ex}“)
safe_copy(“important.txt”， “D:/backups/”)

问答环节（FAQ）

Q1：shutil.copy 和 shutil.copyfile 哪个更快？ A：shutil.copyfile 稍快，因为它不做额外的权限或元数据复制，但如果需要保留文件属性，应选 shutil.copy2。

Q2：使用 shutil.copytree 如何忽略某些文件或文件夹？ A：可以使用自定义的 ignore 函数，忽略 .git 文件夹：

shutil.copytree(src, dst, ignore=shutil.ignore_patterns(“.git”， “__pycache__”))

Q3：为什么我的多线程拷贝没有加速？ A：如果目标磁盘是机械硬盘（HDD），多线程会导致磁头频繁寻道，反而变慢，可尝试改为单线程+大缓冲区，或使用SSD，网络拷贝可用 concurrent.futures 显著提速。

Q4：如何拷贝文件的同时保留软链接？ A：shutil.copytree 默认会复制链接指向的文件内容，使用 symlinks=True 参数可以保留链接本身：

shutil.copytree(src, dst, symlinks=True)

总结与最佳实践

• 首选标准库：shutil 模块覆盖了90%的拷贝需求,简洁且经过良好测试。
• 内存意识：处理大文件时，务必使用逐块读取（read(chunk_size)）。
• 并发策略：小文件多线程可提速；大文件用单线程+异步I/O（如 asyncio 或 aiofiles）更佳。
• 防御性编程：始终检查文件存在性、磁盘空间和权限，并用 try-except 包裹关键代码。
• 路径统一：推荐使用 pathlib.Path，它跨平台（Windows 与 Linux 自动转换）。

通过以上案例，您已经能从简单到复杂、从单文件到整个目录、从串行到并发，全面掌握Python文件复制的精髓，在实际项目中，根据场景灵活选择方案，即可写出高效、健壮的拷贝代码。