Python文件复制方法详解

Python文件复制方法详解

技术背景

在Python编程中,文件复制是一项常见的操作。无论是数据备份、文件迁移还是其他应用场景,都可能需要将一个文件的内容复制到另一个文件或位置。Python提供了多种方式来实现文件复制,不同的方法适用于不同的场景。

实现步骤

1. 使用shutil模块

shutil模块提供了许多文件和目录操作的方法,其中有多个方法可用于文件复制:

  • shutil.copyfile(src_file, dest_file, *, follow_symlinks=True):将源文件的内容复制到目标文件。源文件和目标文件都需要是完整的文件名,包括路径。如果目标文件已存在,会被替换。
1
2
import shutil
shutil.copyfile('source.txt', 'destination.txt')
  • shutil.copy(src_file, dest_file, *, follow_symlinks=True):复制文件,目标可以是文件夹。
1
2
import shutil
shutil.copy('source.txt', 'destination.txt')
  • shutil.copy2(src_file, dest_file, *, follow_symlinks=True):与copy类似,但会保留更多的文件元数据(如时间戳)。
1
2
import shutil
shutil.copy2('source.txt', 'destination.txt')
  • shutil.copyfileobj(src_file_object, dest_file_object[, length]):操作已打开的文件对象来复制文件。
1
2
3
4
5
6
7
8
import shutil
file_src = 'source.txt'
f_src = open(file_src, 'rb')
file_dest = 'destination.txt'
f_dest = open(file_dest, 'wb')
shutil.copyfileobj(f_src, f_dest)
f_src.close()
f_dest.close()

2. 使用os模块

可以通过os模块调用系统命令来复制文件,在不同的操作系统上使用不同的命令:

  • 在Unix/Linux系统中:使用cp命令
1
2
import os
os.system('cp source.txt destination.txt')
  • 在Windows系统中:使用copy命令
1
2
import os
os.system('copy source.txt destination.txt')

3. 使用subprocess模块

subprocess模块可以创建新的进程来执行外部命令,同样可以用于文件复制:

1
2
3
4
5
import subprocess
# 在Linux/Unix系统中
status = subprocess.call('cp source.txt destination.txt', shell=True)
# 在Windows系统中
status = subprocess.call('copy source.txt destination.txt', shell=True)

核心代码

以下是使用shutil模块进行文件复制的核心代码示例:

1
2
3
4
5
6
7
8
9
10
11
12
import shutil

def copy_file(source, destination):
try:
shutil.copy2(source, destination)
print(f"文件 {source} 已成功复制到 {destination}")
except Exception as e:
print(f"复制文件时出错: {e}")

source_file = 'source.txt'
destination_file = 'destination.txt'
copy_file(source_file, destination_file)

最佳实践

  • 优先使用shutil模块shutil模块提供了更高级的文件操作功能,并且跨平台性好,推荐优先使用。
  • 处理异常:在进行文件复制时,可能会出现各种异常(如文件不存在、权限不足等),应该使用try-except语句来捕获并处理这些异常。
  • 保留元数据:如果需要保留文件的元数据(如修改时间、访问时间等),可以使用shutil.copy2()方法。

常见问题

  • 目标文件已存在:在使用shutil.copyfile()shutil.copy()等方法时,如果目标文件已存在,会被直接替换。如果不希望覆盖已有文件,可以在复制前检查文件是否存在。
1
2
3
4
5
6
7
8
9
import os
import shutil

source = 'source.txt'
destination = 'destination.txt'
if not os.path.exists(destination):
shutil.copy2(source, destination)
else:
print(f"目标文件 {destination} 已存在,跳过复制。")
  • 权限问题:如果目标位置没有写入权限,会抛出IOError异常。确保目标位置具有足够的写入权限。
  • 特殊文件无法复制shutil.copyfile()等方法不能复制特殊文件(如字符或块设备、管道等)。

Python文件复制方法详解
https://119291.xyz/posts/2025-05-09.python-file-copying-methods/
作者
ww
发布于
2025年5月9日
许可协议