shutil.copy 用法

`shutil.copy()` 是 Python 中的一个标准库模块，用于在两个路径之间复制文件。它的语法如下：

shutil.copy(src, dst, *, follow_symlinks=True)

其中，`src` 表示源文件的路径，`dst` 表示目标文件的路径。如果 `follow_symlinks` 为 `True`（默认为 `True`），则会处理符号链接而不是链接本身。如果目标文件已经存在，则会被覆盖。如果目标路径不存在，则会抛出异常。

以下是 `shutil.copy()` 的例子：

import shutil

# 复制文件
shutil.copy("/path/to/src/file", "/path/to/dst/file")

# 复制目录
shutil.copytree("/path/to/src/directory", "/path/to/dst/directory")

需要注意的是，如果你想要复制的文件或目录已经存在于目标路径中，`shutil.copy()` 将会覆盖目标路径中的文件或目录。因此，在使用 `shutil.copy()` 时，你应该确保目标路径不存在或者你已经确认可以覆盖它。

相关问题

shutil.copy错误类型

### 关于 `shutil.copy` 的常见错误及其解决方法

#### 文件路径不存在
当源文件路径或目标文件路径不正确时，会引发 FileNotFoundError 或 IOError。

import shutil

try:
    shutil.copy('source_file_path', 'destination_file_path')
except FileNotFoundError as e:
    print(f"File not found: {e}")

确保提供给 `shutil.copy` 函数的源文件路径和目标文件路径是有效的[^1]。

#### 权限不足
尝试复制到受保护的位置或读取权限受限的文件可能会导致 PermissionError。

import os
import shutil

if os.access('source_file_path', os.R_OK) and os.access(os.path.dirname('destination_file_path'), os.W_OK):
    shutil.copy('source_file_path', 'destination_file_path')
else:
    print("Permission denied or path is invalid.")

验证当前程序有足够的权限访问指定的源文件并写入目标位置[^2]。

#### 符号链接处理不当
默认情况下，`follow_symlinks=True` 参数会使 `shutil.copy` 复制实际文件而不是符号链接本身。如果不希望跟随符号链接，则应设置此参数为 False。

shutil.copy('source_link_or_file', 'destination', follow_symlinks=False)

对于更复杂的目录结构复制需求，可以考虑使用 `shutil.copytree()` 方法来保留整个树状结构的同时控制如何处理符号链接[^3]。

#### 并发操作冲突
在同一时间执行多个并发的文件复制任务可能导致数据损坏或其他未定义行为。为了避免这种情况，在多线程环境中应当小心管理资源锁定机制或者采用异步的方式进行文件传输[^5]。

shutil.copy2()

`shutil.copy2()` 是 Python 中 `shutil` 模块提供的一个函数，用于复制文件，并尽可能地保留文件的元数据（如文件权限、最后修改时间等）。

下面是 `shutil.copy2()` 函数的示例用法：

import shutil

source_path = "path/to/source/file.txt"
destination_path = "path/to/destination/file.txt"

# 复制文件并保留元数据
shutil.copy2(source_path, destination_path)

在上述示例中，`source_path` 是要复制的源文件路径，`destination_path` 是目标文件的路径。`shutil.copy2()` 函数会将源文件复制到目标文件路径，并尽可能地保留源文件的元数据。

需要注意的是，如果目标文件已经存在，`shutil.copy2()` 函数会抛出 `shutil.SameFileError` 异常。你可以选择在复制之前检查目标文件是否存在，或使用 `shutil.copy()` 函数进行简单的文件复制。

你可以根据实际需要修改 `source_path` 和 `destination_path` 的值为你想要复制的源文件路径和目标文件路径，然后运行这段代码来复制文件。