pathlib.Path.resolve() 默认追踪符号链接并要求路径存在,否则抛 FileNotFoundError;需先exists()判断或捕获异常;relative_to()仅支持祖先路径;拼接用/运算符而非字符串;比较路径应先resolve()再==。

用 pathlib.Path.resolve() 获取绝对路径,但要注意符号链接
调用 resolve() 是最直接的转绝对路径方式,它会自动处理 ..、. 和符号链接,最终返回真实路径。但默认会追踪符号链接——如果你只想规范化路径而不解析软链,得加参数 strict=False 并配合 absolute():
from pathlib import Path
p = Path("data/../config.yaml")
print(p.resolve()) # /home/user/config.yaml(如果软链存在,会跳进去)
print(p.absolute()) # /home/user/data/../config.yaml(不解析软链,但仍是绝对路径)常见错误是假设 resolve() 总是安全的:如果路径不存在且 strict=True(默认),会抛 FileNotFoundError;生产环境建议先 exists() 判断,或捕获异常。
用 Path.relative_to() 计算相对路径,必须满足祖先关系
relative_to() 不是“任意两路径求相对”,而是要求目标路径必须是调用者的**祖先目录**。比如 Path("/a/b/c").relative_to("/a") 返回 Path("b/c"),但 Path("/a/b").relative_to("/x/y") 会直接报 ValueError: '/a/b' does not start with '/x/y'。
实际中常需要“跨目录”的相对路径(如从 /src/main.py 引用 /tests/test_main.py),这时得手动计算公共前缀:
立即学习“Python免费学习笔记(深入)”;
from pathlib import Path
def get_relative_path(src: Path, dst: Path) -> Path:
return Path("../" * len(src.parent.parts) + str(dst)) # 简化版,仅适用于同级父目录场景
# 更健壮的做法是用 os.path.relpath() 或自己比对 parts别依赖 relative_to() 做通用转换——它只做子集断言,不是路径差值运算。
拼接路径时优先用 / 运算符,别用字符串拼接
Path 对象重载了 /,语义清晰且跨平台:
p = Path("/home/user")
q = p / "docs" / "report.pdf" # 自动处理分隔符,Windows 下也生成 ,但内部统一为 /
print(q) # /home/user/docs/report.pdf(Linux/macOS)或 WindowsPath('C:\user\docs\report.pdf')字符串拼接 "%s/%s" % (p, "file.txt") 或 p + "/file.txt" 会丢失路径对象特性,无法链式调用 .stem、.with_suffix() 等方法,还容易在 Windows 上混用 和 / 导致错误。
注意:/ 只接受 str 或另一个 Path,传入 None 或数字会报 TypeError。
路径比较和存在性判断要用 Path 方法,别用 == 或 str 转换
两个 Path 对象即使指向同一文件,用 == 比较可能为 False(比如一个是 ./file.txt,一个是 /full/path/file.txt)。正确做法是先 resolve() 再比:
p1 = Path("./config.yaml")
p2 = Path("/home/user/project/config.yaml")
print(p1 == p2) # False
print(p1.resolve() == p2.resolve()) # True(如果实际是同一文件)检查是否存在用 .exists(),而不是 os.path.exists(str(p))——后者多一次字符串转换,且失去 Path 的链式能力。另外,.is_file() 和 .is_dir() 在路径不存在时都返回 False,不要误以为是异常信号。
路径操作看似简单,但 resolve() 的 strict 行为、relative_to() 的祖先限制、以及 / 拼接时对输入类型的隐式要求,这几个点最容易在重构或跨平台部署时突然暴露。


















