Python pathlib 复制文件时怎样控制符号链接

Python pathlib 复制符号链接时，用 follow_symlinks 明确选择：True 复制所指对象，False 在目标位置重建链接。Path.copy() 从 Python 3.14 起提供，默认值是 True。若你的目标是保留目录里的链接关系，就不能只凭“文件名没变”判断复制正确。

官方地址：https://docs.python.org/3.14/library/pathlib.html

如果我要做一份能独立读取的资料副本，我会优先考虑内容复制；如果我要保留项目的链接组织方式，我会选择保留链接，并另外检查目录布局。这两种目标不同，没有一个参数值适合所有任务。

链接变成普通文件，先查复制策略

先确认解释器支持 copy，再检查调用是否显式传入参数。源是链接且使用默认策略时，目标不必仍是链接；这并不是文件扩展名造成的。为了让维护者看出意图，我倾向于把 True 或 False 写出来，而不是让默认值承担业务约定。

本例只讨论指向普通文本文件的符号链接，不把硬链接、Windows junction 或整个目录树混在同一个结果判断中。preserve_metadata 是另一项配置，不是保留链接的开关。

保留链接不等于保留可访问目标

设 source/alias.txt 的链接文字是 payload.txt，原目标位于 source/payload.txt。把链接保留到 destination/link-copy.txt 后，这段相对文字仍然要结合新位置理解：对应的是 destination/payload.txt，而不是自动指回原目录。

所以我不会把“链接复制成功”当成“还能读取原内容”。新目录有同名文件时，它可能读到另一份内容；没有同名目标时，链接可能悬空。这里是目录上下文的推导，不是某次线上故障的记录。

用隔离目录对照两种复制写法

下面的原创示例适用于 Python 3.14+ 且能创建文件符号链接的环境。两个目录故意放入不同文字的 payload.txt，以免把链接重建误判为内容复制。这里只提供可复现代码，没有实际运行记录。

import sys
from pathlib import Path
from tempfile import TemporaryDirectory

if sys.version_info 

按这套目录设置推导，data_copy 不是链接，读取的是“原目录内容”；link_copy 是链接，readlink 返回 payload.txt，而读取它得到“新目录内容”。如果这与你本地观察不同，先核对版本、链接类型和目录内容，不要只比较名称。

按对象类型判断结果，而不是只看文件名

is_symlink() 用来识别链接本身，readlink() 用来读取它记录的目标路径；exists() 默认关注所指对象，因此悬空链接可能出现 is_symlink 为真而 exists 为假。需要保留底层错误信息时，使用 stat/lstat，而不是把布尔查询结果解释成唯一故障原因。

复制前留下这份检查清单

• 明确要复制内容还是保留链接，并写出 follow_symlinks。
• 使用全新的目标名称；copy 对已有普通目标文件可以发生替换，示例不用于覆盖业务文件。
• 保留相对链接时，检查新目录中对应目标是否符合任务需要。
• Windows 创建链接还受系统能力和权限影响；不要把创建失败当成参数不生效。
• 旧解释器没有 Path.copy 时，文件复制可以考虑 shutil.copyfile，并明确 follow_symlinks；不要把文件接口直接当成目录树接口。

先调用 resolve 再复制，False 还有效吗？

resolve 会解析符号链接。若传给 copy 的已经是解析后的普通文件路径，False 不会把原链接关系重新变回来。保留链接任务应保留源链接路径这个对象。

保留链接会顺便复制链接目标吗？

本例的单链接复制不会额外把 payload.txt 搬到新目录。是否需要另行复制目标，应由你的打包策略决定。

保留链接是不是总比复制内容省心？

对我来说，只有接收端也理解并维护目录布局时才合适。想要独立阅读副本的读者，更需要明确复制所指内容；想保留引用关系的读者，则需要同时管理链接和目标。

参考文档：https://docs.python.org/3.14/library/pathlib.html#pathlib.Path.copy；文件复制兼容接口：https://docs.python.org/3.14/library/shutil.html#shutil.copyfile。