python怎么复制一个文件_python文件复制操作实现方法

裘德小鎮的故事

发布时间：2025-09-12 20:07:01

627人浏览过

来源于php中文网

原创

最推荐使用shutil.copy2()复制文件，因其能保留文件内容、权限及元数据（如修改时间、访问时间），适用于备份与迁移；若目标文件存在，默认会直接覆盖，可通过os.path.exists()预先检查并处理；复制目录则需用shutil.copytree()，支持递归复制及忽略特定文件。

python怎么复制一个文件_python文件复制操作实现方法

用Python复制文件，最直接且推荐的方式是使用内置的

shutil

模块。它提供了一系列高级文件操作，其中

shutil.copy()

、

shutil.copyfile()

和

shutil.copy2()

是实现文件复制的核心函数，它们各自在处理文件元数据和权限方面有细微差别，但都能有效完成任务。

解决方案

在Python中复制文件，我们通常会依赖

shutil

（shell utilities）模块。这个模块的设计初衷就是为了提供更高级、更方便的文件和目录操作，远比

os

模块里的低级函数来得顺手。

核心函数是

shutil.copy2()

。我的经验告诉我，如果不是有特别明确的需求，比如只复制内容不关心权限，那么

copy2

几乎是你在做文件复制时最稳妥、最全面的选择。它不仅复制了文件的内容，还会尽可能地保留原始文件的元数据，比如修改时间、访问时间、权限位等等。这在做备份或者迁移时尤为重要，能确保新文件与旧文件在系统层面保持一致性。

import shutil
import os

source_file = "my_document.txt"
destination_file = "backup_document.txt"

# 假设my_document.txt存在
# with open(source_file, "w") as f:
#     f.write("这是我的重要文档内容。\n")
#     f.write("一些敏感信息，需要保留权限和时间戳。\n")

try:
    # 使用shutil.copy2()复制文件，保留元数据
    shutil.copy2(source_file, destination_file)
    print(f"文件 '{source_file}' 已成功复制到 '{destination_file}'，并保留了元数据。")

    # 验证一下修改时间是否一致
    src_mtime = os.path.getmtime(source_file)
    dst_mtime = os.path.getmtime(destination_file)
    print(f"源文件修改时间: {src_mtime}")
    print(f"目标文件修改时间: {dst_mtime}")
    if src_mtime == dst_mtime:
        print("修改时间已成功保留。")
    else:
        print("修改时间未能完全保留，可能与文件系统或操作系统有关。")

except FileNotFoundError:
    print(f"错误：源文件 '{source_file}' 不存在。")
except PermissionError:
    print(f"错误：没有权限复制文件到 '{destination_file}'。")
except Exception as e:
    print(f"复制文件时发生未知错误: {e}")

# 另外两个函数简要提一下：
# shutil.copyfile(src, dst)：只复制文件内容，不复制元数据。
# shutil.copy(src, dst)：复制文件内容和权限，但不保证复制所有元数据（比如修改时间）。
# 所以，如果你需要最全面的复制，记住用copy2。

Python复制文件时如何处理目标文件已存在的情况？

这是一个非常实际的问题。默认情况下，

shutil.copy()

、

shutil.copyfile()

和

shutil.copy2()

在目标路径存在同名文件时，都会直接覆盖掉。它们不会像某些图形界面工具那样弹出一个“是否覆盖？”的提示。这在自动化脚本中是方便的，但有时也可能导致数据丢失。

立即学习“Python免费学习笔记（深入）”；

我的做法通常有两种：

预先检查并决定行为：在调用复制函数之前，先用

os.path.exists()

检查目标文件是否存在。如果存在，你可以选择跳过复制、重命名目标文件、或者明确地覆盖。这种方式给了你最大的控制权。

import shutil
import os

source_file = "my_document.txt"
destination_file = "backup_document.txt"

if os.path.exists(destination_file):
    print(f"目标文件 '{destination_file}' 已存在。")
    # 我们可以选择：
    # 1. 询问用户 (在交互式脚本中)
    # 2. 自动重命名目标文件
    # new_destination_file = destination_file + ".bak"
    # os.rename(destination_file, new_destination_file)
    # print(f"已将现有文件重命名为 '{new_destination_file}'。")
    # 3. 直接覆盖 (这是shutil.copy2的默认行为)
    print("将直接覆盖现有文件。")

try:
    shutil.copy2(source_file, destination_file)
    print(f"文件 '{source_file}' 已成功复制到 '{destination_file}'。")
except FileNotFoundError:
    print(f"错误：源文件 '{source_file}' 不存在。")
except Exception as e:
    print(f"复制文件时发生错误: {e}")

利用异常处理：虽然
```
shutil.copy
```
系列函数本身不会因为文件存在而抛出特定的
```
FileExistsError
```
（它们会直接覆盖），但如果你在更复杂的场景下，比如先尝试移动文件，或者自定义了复制逻辑，那么
```
FileExistsError
```
就可能派上用场。不过对于
```
shutil.copy2
```
这种直接覆盖的，这种方式就不太适用了。最稳妥的还是第一种，明确地检查。

Python复制文件与复制目录有什么区别，如何实现？

这是个好问题，因为文件和目录在操作系统层面就是不同的实体。

shutil.copy()

系列函数是专门用来复制单个文件的。如果你想复制整个目录，包括它里面的所有子目录和文件，那就需要用到

shutil.copytree()

。

百度作家平台

百度小说旗下一站式AI创作与投稿平台。

下载

shutil.copytree(src, dst, symlinks=False, ignore=None, copy_function=copy2, ignore_dangling_symlinks=False, dirs_exist_ok=False)

```
src
```
：源目录的路径。
```
dst
```
：目标目录的路径。
```
symlinks
```
：如果为
```
True
```
，符号链接会被复制为符号链接；如果为
```
False
```
（默认），符号链接会被复制为它们指向的实际文件或目录。
```
ignore
```
：一个可调用对象，它接受目录名和目录中的文件列表，返回一个要忽略的文件名列表。这在复制时排除某些文件（比如
```
.git
```
目录、
```
__pycache__
```
）时非常有用。
```
copy_function
```
：指定用于复制文件的函数，默认为
```
shutil.copy2
```
。
```
dirs_exist_ok
```
：Python 3.8+ 新增参数。如果为
```
True
```
，目标目录可以存在，
```
copytree
```
会尝试合并内容；如果为
```
False
```
（默认），目标目录必须不存在，否则会抛出
```
FileExistsError
```
。

实现示例：

import shutil
import os

source_dir = "my_project_folder"
destination_dir = "project_backup"

# 假设my_project_folder存在，并有一些文件和子目录
# os.makedirs(os.path.join(source_dir, "sub_dir"), exist_ok=True)
# with open(os.path.join(source_dir, "file1.txt"), "w") as f: f.write("Hello")
# with open(os.path.join(source_dir, "sub_dir", "file2.txt"), "w") as f: f.write("World")

try:
    # 复制整个目录
    # 注意：如果destination_dir已存在且dirs_exist_ok=False，会报错
    shutil.copytree(source_dir, destination_dir, dirs_exist_ok=True)
    print(f"目录 '{source_dir}' 已成功复制到 '{destination_dir}'。")

    # 举个例子，如何使用ignore参数排除文件
    # def ignore_pycache(directory, contents):
    #     return [c for c in contents if c == '__pycache__' or c.endswith('.pyc')]
    # shutil.copytree(source_dir, "project_backup_no_pycache", ignore=ignore_pycache)
    # print("目录复制完成，并忽略了__pycache__。")

except FileExistsError:
    print(f"错误：目标目录 '{destination_dir}' 已存在。请删除或使用dirs_exist_ok=True。")
except FileNotFoundError:
    print(f"错误：源目录 '{source_dir}' 不存在。")
except Exception as e:
    print(f"复制目录时发生错误: {e}")

Python复制文件时如何保留文件权限和修改时间？

这正是

shutil.copy2()

的用武之地，也是它与

shutil.copy()

和

shutil.copyfile()

最主要的区别。

```
shutil.copyfile(src, dst)
```
: 这个函数是最基础的，它只负责将
```
src
```
文件的内容复制到
```
dst
```
。它不关心任何元数据，比如权限、修改时间、创建时间等。目标文件会获得当前用户/进程默认的权限和新的时间戳。如果你只是想快速复制文件内容，且不关心其他任何属性，它可能最快。
```
shutil.copy(src, dst)
```
: 这个函数比
```
copyfile
```
进了一步，它会复制文件内容，并且会尝试复制源文件的权限位（
```
st_mode
```
）。但是，它通常不会复制其他元数据，比如修改时间（
```
st_mtime
```
）和访问时间（
```
st_atime
```
）。在某些操作系统上，它可能表现得更像
```
copy2
```
，但在跨平台或特定场景下，其行为可能不如
```
copy2
```
一致。
```
shutil.copy2(src, dst)
```
: 这是我个人最推荐的。它不仅复制了文件内容，还会尽力复制所有可用的元数据，包括权限位、修改时间、访问时间，甚至在某些系统上还有扩展属性。这使得目标文件成为源文件的一个近乎完美的副本，对于备份、归档或任何需要保持文件属性一致性的任务来说，都是最佳选择。