Python 3.12+：如何让自定义Path子类仅使用自身实现方法

核心结论：不建议直接子类化pathlib.Path #

pathlib.Path的设计紧密绑定本地文件系统，即便Python 3.12开放了子类化权限，它的大量内部逻辑依赖OS系统调用与本地状态。针对S3、SFTP这类远程存储场景，直接子类化会陷入“被迫重写几乎所有方法”的困境，还容易因父类新增方法引发意外调用风险，不符合Python“显式优于隐式”的设计原则。

更符合Python风格的实现方案 #

1. 用抽象基类定义独立接口 #

先定义一套适配各类远程存储的抽象接口，明确必须实现的方法边界：

from abc import ABC, abstractmethod

class RemotePath(ABC):
    @classmethod
    @abstractmethod
    def from_connection(cls, conn):
        pass

    @abstractmethod
    def read_text(self, encoding=None, errors=None):
        pass

    @abstractmethod
    def write_text(self, text, encoding=None, errors=None):
        pass

    # 按需扩展其他抽象方法，如exists()、mkdir()等

2. 实现具体的远程存储类 #

针对不同存储类型编写独立实现类，完全脱离pathlib.Path的约束：

class S3Path(RemotePath):
    def __init__(self, s3_client, bucket, key):
        self.s3_client = s3_client
        self.bucket = bucket
        self.key = key

    @classmethod
    def from_connection(cls, s3_client, bucket, key):
        return cls(s3_client, bucket, key)

    def read_text(self, encoding=None, errors=None):
        response = self.s3_client.get_object(Bucket=self.bucket, Key=self.key)
        content = response['Body'].read()
        return content.decode(encoding or 'utf-8', errors=errors)

    def write_text(self, text, encoding=None, errors=None):
        encoded_text = text.encode(encoding or 'utf-8', errors=errors)
        self.s3_client.put_object(Bucket=self.bucket, Key=self.key, Body=encoded_text)

    # 未实现的方法主动抛出异常
    def mkdir(self):
        raise NotImplementedError("S3Path不支持此类目录创建操作")

3. 可选：添加pathlib风格语法糖 #

如果习惯pathlib的链式调用体验，可以在实现类中自主添加类似方法：

class S3Path(RemotePath):
    # ... 已有方法 ...

    def joinpath(self, *parts):
        new_key = '/'.join((self.key, *parts))
        return S3Path(self.s3_client, self.bucket, new_key)

    @property
    def name(self):
        return self.key.split('/')[-1]

不推荐子类化pathlib.Path的原因 #

• 依赖绑定过紧：Path内部大量依赖os模块、文件描述符等本地特性，远程存储完全不匹配，重写所有方法等于“空继承”，无实际意义。
• 兼容性风险：Python后续版本给Path新增方法时，子类会自动继承这些默认适配本地文件系统的方法，引发意外行为。
• 违反单一职责：Path的职责是处理本地文件系统路径，远程存储有独立的协议与操作逻辑，强行继承会混淆职责边界。

内容的提问来源于stack exchange，提问作者Frank Vel