shutil.copyfile()只复制文件内容，不复制权限和元数据；shutil.copy()还复制权限，且目标可为目录。超大文件应选copyfile()，更轻量可控，避免权限操作失败。
shutil.copyfile() 和 shutil.copy() 有啥区别，该选哪个？
复制超大文件时，shutil.copyfile() 是更轻量、更可控的选择。它只做一件事：把源文件内容原样写入目标路径，不复制权限、时间戳或元数据；而 shutil.copy() 内部会调用 copyfile() + copystat()，后者会尝试设置目标文件的权限和修改时间——这对 NFS、某些容器挂载卷或只读挂载点可能失败，还多一次系统调用，纯属冗余。
-
shutil.copyfile()接受两个str路径参数，目标必须是完整文件路径（不能是目录） -
shutil.copy()第二个参数可以是目录，但对超大文件没优势，反而容易因权限操作中断 - 如果你只要“内容到位”，别用
shutil.copy()；真需要保留权限，单独用os.chmod()或shutil.copystat()分步控制
复制卡住或内存爆掉？得手动控制缓冲区
shutil.copyfile() 默认使用 64MB 缓冲区（Python 3.12+），看似够大，但实际行为取决于底层 os.sendfile() 是否可用。在 Linux 上若源/目标都支持 sendfile()，它会绕过用户态内存直接内核零拷贝；否则退回到 read()/write() 循环，此时缓冲区大小就关键了。
- 小缓冲（如 8KB）会导致系统调用次数爆炸，I/O 效率骤降
- 过大缓冲（如 512MB）可能触发内存分配失败，尤其在内存受限环境（Docker、CI runner）
- 实测 8–64MB 之间较稳：用
shutil.copyfileobj()自定义流式复制更可靠
with open(src, "rb") as fsrc, open(dst, "wb") as fdst:
shutil.copyfileobj(fsrc, fdst, length=32 * 1024 * 1024) # 32MB buffer
如何监控进度又不拖慢复制速度？
不要在每次 read() 后都更新进度条——高频打印或回调会严重拖慢吞吐。正确做法是按固定字节数（比如每 100MB）触发一次状态更新：
- 在
copyfileobj()循环中累计已复制字节数 - 每达到阈值才调用一次
print()或发事件，避免 I/O 竞争 - 别用
tqdm包裹文件对象，它会强制分块读取，破坏大块传输优势
total = os.path.getsize(src)
copied = 0
chunk = 32 * 1024 * 1024
with open(src, "rb") as fsrc, open(dst, "wb") as fdst:
while True:
buf = fsrc.read(chunk)
if not buf:
break
fdst.write(buf)
copied += len(buf)
if copied % (100 * 1024 * 1024) == 0: # 每100MB打点
print(f"→ {copied}/{total} bytes")
遇到 PermissionError 或 OSError: [Errno 27] File too large？
这不是 shutil 的锅，而是底层限制暴露：
-
OSError: [Errno 27] File too large：常见于 32 位 Python 或旧版 ext3 文件系统，最大文件 2GB；换 64 位 Python + ext4/XFS 即可 -
PermissionError: [Errno 13] Permission denied：目标目录无写权限，或目标路径存在但被占用（Windows 下尤其常见）；检查os.access(dst_dir, os.W_OK)，并确保目标文件未被其他进程打开 - 复制到网络路径（SMB/NFS）失败时，优先试
shutil.copyfile()而非shutil.copy2()，跳过元数据操作可绕过多数挂载限制
超大文件复制真正的瓶颈往往不在 Python 层，而在磁盘队列深度、文件系统日志模式、是否启用写缓存——shutil 只负责把数据推过去，剩下的得看你的 /proc/sys/vm/dirty_ratio 和 mount 选项。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
