Python pathlib.Path.readlink 读取符号链接目标的方法

要读取符号链接保存的目标路径，使用 Path.readlink()。返回值是 Path 对象，不会自动转成绝对路径，也不会沿着整条链接链找到最终文件。迁移旧的 os.readlink 代码时，必须保留相对路径和目标存在性这两个边界。

适用范围为 Python 3.9 及以上，且平台提供相应能力。官方文档：https://docs.python.org/3.15/library/pathlib.html#pathlib.Path.readlink；底层接口：https://docs.python.org/3.15/library/os.html#os.readlink。

先用最小调用替换字符串包装

from pathlib import Path

link = Path("/srv/app/current")
try:
    saved_target = link.readlink()
except OSError as exc:
    # 保留错误原因，不用空路径掩盖失败
    print(f"读取失败：{exc}")
else:
    # 这里得到保存目标，不代表文件存在
    print(saved_target)

请将示例入口换成实际符号链接。如果链接保存的是 releases/v2，返回的 Path 表达的仍是 releases/v2，而不是 /srv/app/releases/v2。以上为条件说明，未声称运行结果。

旧代码 Path(os.readlink(link)) 通常可改成 link.readlink()。最低运行环境仍是 Python 3.8 时，应保留旧写法。若调用方依赖字符串类型，应在序列化或接口边界用 str(saved_target) 显式转换。

相对目标要以链接父目录为基准

不要直接将 link.readlink().resolve() 当作链接的最终目标。返回的相对 Path 不携带链接父目录信息，直接 resolve 会从当前工作目录解释它，程序换个启动目录就可能得到不同结果。

from pathlib import Path

def target_candidate(link: Path) -> Path:
    # 固定入口位置，但不提前跟随链接
    located_link = link.absolute()
    saved_target = located_link.readlink()
    if saved_target.is_absolute():
        return saved_target
    # 相对目标以链接父目录为基准
    return located_link.parent / saved_target

candidate = target_candidate(Path("/srv/app/current"))
print(candidate)

入口 /srv/app/current 保存 releases/v2 时，候选路径为 /srv/app/releases/v2。这个结果仅代表路径构造，不证明对象存在，也不保证没有其他符号链接。遇到 .. 不要自行删除路径段：父目录本身可能涉及链接，纯词法删段可能改变含义。

如果需求是找到最终现存文件，应直接对原入口调用 link.resolve(strict=True)。链接清单保存 readlink 的结果，实际访问前需要的最终路径则由 resolve 获取，字段名称也应体现这一区别。

失效链接仍然可以读取保存目标

目标文件删除后，符号链接记录可以继续存在。readlink 读取的是记录中的路径，并不要求目标存在。下面仅在临时目录内创建和删除演示对象。

from pathlib import Path
from tempfile import TemporaryDirectory

with TemporaryDirectory() as directory:
    root = Path(directory)
    target = root / "report.txt"
    target.write_text("示例", encoding="utf-8")
    link = root / "current"
    # 将相对文件名保存进链接
    link.symlink_to("report.txt")
    print(link.readlink())

    # 仅删除临时目录内的演示目标
    target.unlink()
    print(link.is_symlink())  # 稳定示例中预期为 True
    print(link.exists())      # 稳定示例中预期为 False
    print(link.readlink())    # 仍可表示 report.txt
    try:
        link.resolve(strict=True)
    except FileNotFoundError:
        print("目标文件已经不存在")

预期值只描述示例条件，不是执行回执。Windows 创建链接可能需要相应权限或开发者模式。实际业务中 exists 返回 False 也可能与不可访问等原因有关，不能仅凭一个布尔值判断具体错误；需要详细原因时，应使用会保留异常信息的操作。

resolve(strict=False) 会尽量解析路径，并追加未检查的剩余部分。因此即使得到绝对 Path，也不能证明文件存在。readlink 则只返回当前这一环的保存目标，不会递归列出链接链。

迁移时保留异常和版本差异

不要在需要支持旧版 Python 的代码中无条件导入新版本才有的异常名称。若必须兼容不提供链接读取能力的平台，可在能力兼容层处理 NotImplementedError；UnsupportedOperation 继承该异常。文件系统错误则单独按 OSError 处理，避免把“不支持”与“路径不存在”记成同一种问题。

先调用 is_symlink 再 readlink 也不保证成功：两次操作之间目录项可能改变，最终仍以读取返回值或异常为准。Windows 底层结果可能带系统路径前缀，不应为了展示美观就修改实际访问值。

迁移清单

• 调用端是否接受 Path，字符串接口是否显式转换。
• 相对目标是否基于链接父目录，而非当前工作目录。
• 业务字段表示保存目标、候选路径还是最终路径。
• 异常是否区分读取失败、平台能力缺失与最终解析失败。

常见问题

readlink 会读取目标内容吗？

不会，只返回链接保存的路径。读取内容需要另行使用 read_text、read_bytes 或 open。

目标还是链接时，返回最终文件吗？

不会自动递归解析。需要最终现存路径时对原入口调用 resolve(strict=True)，并处理失败。

硬链接可以这样查询原文件名吗？

不可以。硬链接没有符号链接那样保存的目标路径文本，readlink 不能提供所谓原始文件名。

readlink 成功后就一定能打开文件吗？

不一定。目标可能已经失效，或在后续访问前改变。读取链接目标和打开文件是不同操作，后者也需要处理异常。