Python pathlib.Path.copy 如何保留目标目录结构

我第一次把项目素材归档到备份目录时，真正容易搞错的不是“能不能复制”，而是 target 到底表示最终路径，还是一个已经存在的父目录。Python 3.14 的 pathlib.Path 新增了 copy() 和 copy_into()：前者指定复制后的目标路径，后者把文件或目录树放进已有目录。想保留清晰的目录层级，先把这两个语义分开。

官方文档：https://docs.python.org/3.14/library/pathlib.html

一句话判断：要得到 backup/assets 这个明确结果，用 source.copy(backup / "assets")；已经有 backup，希望自动放入源对象本身，则用 source.copy_into(backup)。两者都要求运行环境支持 Python 3.14。

先判断：你要的是最终路径，还是目标父目录

标题里说的“保留目标目录结构”，常见场景是源目录为 project/assets，备份根目录为 backup。如果最终想得到 backup/assets，目标路径必须明确写出来；如果备份根目录已经创建，只想把整个 assets 放进去，才适合使用 copy_into()。

用 Path.copy 显式控制副本的最终位置

我更倾向在备份脚本里先构造完整目标，再调用 copy()。这样目录名、日期分区和版本目录都写在一个 Path 表达式里，审查代码时不需要猜复制器会不会再套一层源目录。

from pathlib import Path

# 源目录是一个完整的素材树，目标写成复制后的最终路径
source = Path("project/assets")
backup_root = Path("backup/2026-09-12")
target = backup_root / source.name

# 这里假定 backup_root 已由上游任务准备好
copied = source.copy(target, preserve_metadata=True)
print(f"副本位置：{copied}")

这里的 target 是 backup/2026-09-12/assets，返回值也是指向这个副本的新 Path。preserve_metadata=True 会在平台支持时一并保留权限、标志、访问与修改时间以及扩展属性；Windows 上复制文件时元数据本来就由系统保留。

用 Path.copy_into 保留源目录名

如果脚本只知道“放进哪个备份根目录”，而不想手动拼接源目录名，可以让 copy_into() 表达这个意图。它的参数必须是已经存在的目录，不是一个待创建的最终路径。

from pathlib import Path

# 目标父目录必须先存在；复制结果会带上 source.name
source = Path("project/assets")
backup_root = Path("backup/2026-09-12")
backup_root.mkdir(parents=True, exist_ok=True)

# follow_symlinks=False 时，源目录树中的符号链接按链接本身复制
copied = source.copy_into(
    backup_root,
    follow_symlinks=False,
    preserve_metadata=True,
)
print(f"目录树已放入：{copied}")

默认 follow_symlinks=True，遇到符号链接会复制它指向的目标；设为 False 才是重建链接本身。生产归档前要先决定你要的是“归档内容”还是“归档链接关系”，不要只看到复制成功就结束判断。

目标已存在、版本较旧时的处理清单

我会在任务开始前记录三个事实：目标是否存在、源是否为链接、解释器是否为 3.14 及以上。Path.copy() 对源文件覆盖已存在目标文件；目录复制涉及目标类型和目录内容时，不应把“重复运行”默认为安全覆盖，最好让备份目录按批次唯一化，或者在复制前明确清理策略。

如果线上仍是 Python 3.13 或更早版本，Path.copy 并不存在。目录树可以退回 shutil.copytree()，文件可以使用 shutil.copy2()；这条兼容路径要单独写清楚，不要在运行时捕获 AttributeError 后悄悄改变归档规则。

import sys
from pathlib import Path
from shutil import copytree

# 旧版本明确走兼容分支，避免把复制语义隐藏在异常处理中
if sys.version_info 

排障时不要只检查返回值，还要确认副本路径、目录名、符号链接策略和元数据是否符合任务要求。对重要备份，可以先复制到临时批次目录，清单确认后再改名切换；这样失败不会直接污染正在使用的备份根目录。

相关问题

Path.copy 和 shutil.copytree 怎么选？

Python 3.14 及以上、希望用 Path 对象表达目标和链接策略时，优先用 Path.copy 或 copy_into；需要兼容旧解释器时使用 shutil.copytree 等传统 API。

preserve_metadata 默认为什么是 False？

默认只保证目录结构和文件数据，复制任务不会无意中把所有权限、时间戳和扩展属性带到新环境。归档、部署或权限敏感场景再显式开启，并结合目标平台检查。

copy_into 的目标目录不存在怎么办？

先用 mkdir(parents=True, exist_ok=True) 创建父目录，再调用 copy_into。如果你需要它直接代表最终路径，则改用 copy(target)。