Python 教程 / 预览批量文件复制并拒绝覆盖
批量文件处理应先列出计划,再明确执行。本练习把样例准备、默认 dry-run(预览)与 --apply 复制分开,只复制指定目录中的文本文件,并拒绝覆盖已有目标;它不移动或删除原文件。
确定范围并单独准备样例
在全新的可丢弃练习目录工作,只使用其下的 copy-demo/in 与 copy-demo/out。先核对当前目录,不要在真实业务目录直接运行。工具只匹配输入目录的 .txt 项,不递归扫描子目录,并排除匹配到的符号链接条目。
先将下面完整 Python 代码以 UTF-8 保存为 setup_copy.py,执行 python setup_copy.py。它是准备步骤,会创建目录与 note.txt,不属于只读预览:
from pathlib import Path
source = Path("copy-demo/in")
source.mkdir(parents=True, exist_ok=True)
with (source / "note.txt").open("x", encoding="utf-8") as f:
f.write("demo\n")
print("sample ready")
应看到 sample ready。文件以 x 模式创建,所以已有同名文件时会拒绝覆盖;不要反复执行准备脚本后把这个错误当成复制工具故障。样例准备完成后,继续保存下一份工具。
本例把复制、验证与清理拆开。移动还会影响源位置,不能将复制成功直接视作已经可以自动删除源文件。文件复制行为见Python 官方 shutil 文档,相对路径基准见pathlib 路径说明。
先运行默认预览
将以下完整内容以 UTF-8 保存为 safe_copy.py。在同一目录使用项目环境执行 python safe_copy.py;若已核对的命令是 python3,则相应使用 python3。本例只需标准库,先完成上面的准备步骤:
import argparse
import hashlib
import shutil
from pathlib import Path
parser = argparse.ArgumentParser()
parser.add_argument("--apply", action="store_true")
args = parser.parse_args()
source, target = Path("copy-demo/in"), Path("copy-demo/out")
if not source.is_dir():
parser.error("prepare copy-demo/in first")
files = sorted(p for p in source.glob("*.txt") if p.is_file() and not p.is_symlink())
for src in files:
dst = target / src.name
if dst.exists() or dst.is_symlink():
raise FileExistsError(dst)
print("copy", src.name)
if args.apply:
target.mkdir(parents=True, exist_ok=True)
with src.open("rb") as incoming, dst.open("xb") as outgoing:
shutil.copyfileobj(incoming, outgoing)
if hashlib.sha256(src.read_bytes()).digest() != hashlib.sha256(dst.read_bytes()).digest():
raise RuntimeError("copy verification failed")
print("applied" if args.apply else "dry-run")
全新目标的预期输出:
copy note.txt
dry-run
此时会列出 note.txt,但不创建 copy-demo/out 或目标文件。先确认源目录、计划文件名与工作目录都是你希望的位置。源目录不存在时,程序通过参数错误停止,而不是默默在错误目录继续。
这个预览也会检查名称冲突。若已存在目标,即使不带 --apply,也可能报 FileExistsError;只读并不意味着它必须忽略冲突。文件列表按名称排序,若为空则只显示 dry-run。
明确执行并检查内容与重复运行
确认计划后再执行:
python safe_copy.py --apply
首次执行应打印 copy note.txt 与 applied,并创建 copy-demo/out/note.txt。目标以 xb(二进制排他创建)打开,即使此前检查后又出现同名文件,这次创建也会拒绝覆盖。源文件用 rb 读取,copyfileobj 复制字节流;with 关闭后再比较源与目标的 SHA-256 摘要。
打开两份 note.txt,应都有 demo 这一行。再执行同一个 --apply 命令,应报 FileExistsError,并保留已经生成的目标。不要为了重复试验直接切换为可覆盖模式;使用另一个新的练习目录可以从准备步骤重新开始。
摘要相同用于检查本例复制结果的字节是否一致,不会验证权限、所有元数据或来源可信性。处理失败也可能留下部分目标文件,并且较早复制的其他文件不会自动回滚。先检查实际路径与内容,再按明确恢复政策决定是否重试,异常处理基础见异常与失败传递。
扩展批量操作前确认限制
copyfileobj 本身可以分块复制,但这里的 read_bytes 摘要计算将整个小文件读入内存。大文件应改为分块摘要。源文件如果同时被别的程序修改,比较结果也可能受影响,不能把此示例当作不可变快照或多文件事务。
排除条目本身的符号链接,不等于保护所有父目录都无法被替换。这是可信的独立练习目录工具,不是用于防御恶意用户同时改动目录的安全边界。也不保证复制所有访问控制、文件所有者和平台特有元数据。
- 复制前检查 dry-run 没有创建 out;复制后检查 note.txt 内容和源文件仍存在。
- 重新执行,确认拒绝覆盖且目标内容不变。若遇到冲突,先辨认已有内容,不要自动编号后假装计划仍相同。
- 扩展到改名、移动或删除之前,先设计完整目标清单、冲突检查、备份与恢复流程。清理时也要核对解析后的绝对路径确实属于这次可丢弃的 copy-demo,只处理已确认的结果。




