Python案例如何复制移动文件？

wen python案例 2026-06-11 10

Python案例：如何高效复制与移动文件？实战技巧与常见问题全解析

目录导读

引言：文件操作在Python中的重要性
核心模块：shutil与os的对比与选择
复制文件的4种实战案例
- 1 基本复制：shutil.copy()
- 2 保留元数据：shutil.copy2()
- 3 复制目录：shutil.copytree()
- 4 带权限的复制：shutil.copyfile()
移动文件的3种高效方法
- 1 简单移动：shutil.move()
- 2 跨设备移动：os.rename()的局限与shutil优势
- 3 批量移动：结合glob与循环
常见错误处理与最佳实践
问答环节：你关心的问题都在这里
总结与进阶建议

文件操作在Python中的重要性

在日常开发或数据处理工作中,复制和移动文件是再常见不过的需求，无论是备份配置文件、迁移日志文件，还是自动化处理数据集，Python都提供了强大而简洁的接口，许多初学者容易混淆shutil和os模块的功能，或者忽略异常处理导致程序崩溃，本文将基于实际案例，手把手教你如何安全、高效地完成文件复制与移动，并回答那些搜索引擎上也难以找到的细节问题。

Python案例如何复制移动文件？

核心模块：shutil与os的对比与选择

Python标准库中,os模块提供底层文件操作（如os.rename、os.remove），而shutil（Shell Utilities）专为高级文件操作设计，包含复制、移动、删除等函数。

复制文件：优先使用shutil（shutil.copy vs shutil.copy2取决于是否保留元数据）。
移动文件：shutil.move比os.rename更灵活，尤其适用于跨文件系统或跨磁盘移动（因为os.rename要求源和目标在同一文件系统）。

案例场景：我们要将/data/logs/app.log复制到/backup/2023/logs/下，并保留原始时间戳。

复制文件的4种实战案例

1 基本复制：shutil.copy()

import shutil
source = '/data/logs/app.log'
dest = '/backup/2023/logs/app.log'
shutil.copy(source, dest)  # 仅复制内容，不含权限和时间戳

输出：/backup/2023/logs/app.log已存在但内容更新，注意：目标路径中如果logs目录不存在则会报错，必须确保目录存在（下文会讲如何处理）。

2 保留元数据：shutil.copy2()

shutil.copy2(source, dest)  # 尝试保留文件时间、权限等元数据

适用场景：当需要备份文件且希望保留原始创建/修改时间时，这是首选，但注意：在Windows上可能无法保留某些高级属性（如NTFS安全描述符）。

3 复制目录：shutil.copytree()

假设要复制整个/data/logs/目录到/backup/logs/：

shutil.copytree('/data/logs', '/backup/logs')  
# 如果目标目录已存在会报错，除非设置 dirs_exist_ok=True（Python 3.8+）
shutil.copytree('/data/logs', '/backup/logs', dirs_exist_ok=True)

注意：copytree默认不复制软链接指向的目标文件，而是复制链接本身，可以通过symlinks=True参数控制。

4 带权限的复制：shutil.copyfile()

当只需要复制文件内容（不保留元数据、权限、目录结构）时：

import shutil
shutil.copyfile('source.txt', 'dest.txt')

与shutil.copy的区别：copyfile要求目标路径必须是一个完整的文件名（不含目录），如果目标目录不存在会报错，而shutil.copy允许目标是一个目录名（此时会将源文件名作为新文件名放入该目录）。

移动文件的3种高效方法

1 简单移动：shutil.move()

shutil.move('/data/old.txt', '/backup/new.txt')

行为：如果目标路径是目录，文件会移入该目录并保持原名；如果目标路径包含具体文件名，则移动并重命名，在同一个文件系统内，它本质上是os.rename；否则使用shutil.copy2+os.remove组合。

2 跨设备移动：os.rename()的局限与shutil优势

import os
os.rename('/data/test.txt', '/mnt/usb/test.txt')  # 可能失败：跨设备移动

报错信息通常为OSError: [Errno 18] Invalid cross-device link，解决方案是使用shutil.move：

shutil.move('/data/test.txt', '/mnt/usb/test.txt')  # 自动处理跨设备

3 批量移动：结合glob与循环

假设需要移动/data/下所有.log文件到/backup/logs/：

import glob, shutil, os
src_dir = '/data/'
dst_dir = '/backup/logs/'
os.makedirs(dst_dir, exist_ok=True)  # 预创建目标目录
for file_path in glob.glob(os.path.join(src_dir, '*.log')):
    shutil.move(file_path, dst_dir)  # 或 shutil.copy2 后删除
    print(f"已移动：{file_path} -> {dst_dir}")

性能提示：批量操作时，频繁调用shutil.move可能稍慢，但可读性强，如果数据量极大（数万文件），建议考虑使用多线程或pathlib库。

常见错误处理与最佳实践

1 目录不存在：自动创建

import os, shutil
dest_dir = '/backup/new/subdir'
os.makedirs(dest_dir, exist_ok=True)  # 递归创建目录
shutil.copy2('src.txt', dest_dir + '/src.txt')

2 文件已存在：覆盖或跳过

import os
if not os.path.exists(dest_path):
    shutil.copy2(src, dest)
else:
    print("目标文件已存在，跳过。")

也可以使用shutil.copy2时的默认覆盖行为——但要注意：如果文件内容重要，最好先备份。

3 权限不足：捕获异常

try:
    shutil.move('/etc/secret.txt', '/tmp/secret.txt')
except PermissionError:
    print("没有权限移动该文件，请以管理员身份运行脚本。")
except Exception as e:
    print(f"未知错误：{e}")

问答环节：你关心的问题都在这里

Q1: 复制大文件时如何显示进度？
A: 可以使用shutil.copyfileobj配合tqdm库，或循环读取块数据并更新进度条。

import shutil, tqdm
with open(src, 'rb') as fsrc, open(dest, 'wb') as fdst:
    total = os.path.getsize(src)
    with tqdm.tqdm(total=total, unit='B', unit_scale=True) as pbar:
        while True:
            chunk = fsrc.read(1024*1024)  # 1MB
            if not chunk: break
            fdst.write(chunk)
            pbar.update(len(chunk))

Q2: shutil.move和os.rename在效率上有什么区别？
A: 在同一个文件系统内，两者都是重命名操作（O(1)时间），但os.rename无法跨文件系统，而shutil.move会自动判断并采用复制+删除策略，此时效率取决于文件大小和磁盘速度。

Q3: 如何复制文件的同时保留软链接？
A: 使用shutil.copy2默认会复制软链接本身（而不是链接指向的文件），但os.rename会跟随链接，如果想复制链接指向的实际内容，需要用shutil.copy2后手动处理，更稳妥的方法是使用shutil.copytree的symlinks=True参数（仅对目录递归有效）。

Q4: 在Windows上如何避免文件占用导致的失败？
A: 可以尝试先读取文件内容再写入（绕过锁定），或使用pywin32库的win32file开放共享模式，更简单的做法是捕获PermissionError并重试几次。