继承multiprocessing.Queue报错，是否误解Python官方文档？

问题场景 #

为实现Work Manager风格的多进程队列，我编写了继承multiprocessing.Queue的WMQueue类，代码如下：

from multiprocessing import Queue

class WMQueue(Queue):
    def __init__(self):
        super().__init__()
    def __enter__(self):
        return self
    def __exit__(self, *_):
        self.close()

运行时触发异常：

TypeError: method expected 2 arguments, got 3

经排查发现multiprocessing.Queue实际是一个方法，但Python官方文档标注它为类：class multiprocessing.Queue([maxsize])。该方法返回multiprocessing.queues.Queue类型对象，此类型无公开文档，子类化可能不安全。我知晓其他实现方式，但疑惑为何文档与实际不符，是否是我误解了Python文档？

原因解析 #

• multiprocessing.Queue本质是一个工厂函数，而非直接的类。它的作用是根据当前的进程启动上下文（如fork/spawn模式）返回适配的队列实现实例，也就是你看到的multiprocessing.queues.Queue（不同平台或启动方式可能返回不同的队列子类）。
• 官方文档将其标注为类是一种简化的用户视角表述：对于使用者来说，它的调用方式和类完全一致——通过Queue([maxsize])实例化，返回的对象拥有统一的公共接口，无需关心底层实际的类实现。这种写法在Python标准库中很常见，目的是隐藏复杂的实现细节，提供一致的使用体验。
• 你继承时出现TypeError，是因为工厂函数不支持子类化：当你调用super().__init__()时，继承机制会向这个工厂函数传递额外的参数，导致参数数量不匹配，从而触发异常。

替代实现方案 #

既然无法直接继承multiprocessing.Queue，可以用组合而非继承的方式实现需求，既保留上下文管理器特性，又规避子类化未公开类的风险：

from multiprocessing import Queue

class WMQueue:
    def __init__(self):
        self._inner_queue = Queue()
    
    def __enter__(self):
        return self
    
    def __exit__(self, *_):
        self._inner_queue.close()
    
    # 代理队列的核心方法，根据需求添加
    def put(self, item, block=True, timeout=None):
        self._inner_queue.put(item, block, timeout)
    
    def get(self, block=True, timeout=None):
        self._inner_queue.get(block, timeout)
    
    def qsize(self):
        return self._inner_queue.qsize()
    
    def empty(self):
        return self._inner_queue.empty()
    
    def full(self):
        return self._inner_queue.full()
    
    def close(self):
        self._inner_queue.close()

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