Spacy中doc.ents为Python元组却可赋值？新手疑问

你观察得没错——当读取doc.ents时，它确实返回的是一个不可变的元组，比如执行print(type(doc.ents))会得到<class 'tuple'>，这意味着你没法直接对它做append、remove这类修改操作。

但spaCy给doc.ents这个属性做了特殊封装：它用Python的@property机制实现了getter（读取）和setter（赋值）方法：

• 读取时：返回的是内部存储的实体数据的元组副本，保证外部不能直接修改底层数据；
• 赋值时：调用的是专门的setter方法，它会接收你传入的可迭代对象（比如列表、元组），将其转换为符合要求的实体结构，然后更新doc内部的实体存储——这不是直接给元组赋值，而是通过封装的逻辑完成了实体的更新。

举个简化的类比，类似这样的类实现逻辑：

class MockDoc:
    def __init__(self):
        self._internal_ents = ()  # 内部用元组存实体
    
    @property
    def ents(self):
        return self._internal_ents  # 读取时返回元组
    
    @ents.setter
    def ents(self, new_ents):
        # 赋值时把传入的可迭代对象转成元组，更新内部存储
        self._internal_ents = tuple(new_ents)

在这个例子里，你同样可以做mock_doc.ents = [span1, span2]，但读取mock_doc.ents得到的是元组。

回到你的代码，doc.ents = [span_with_label]就是通过这种setter机制，完成了实体的添加，而不是直接修改元组本身。

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