spaCy中`property my_property:`含义及与`@property`的区别

你在.pyx后缀的源码文件中看到的property my_property:不是标准Python语法，是Cython为C级扩展类设计的专用属性定义语法，因此在Python官方文档中无法查到对应说明。

具体功能 #

该语法仅可在Cython的cdef class（Cython实现的静态类型扩展类，执行性能远高于纯Python类）中使用，作用和Python原生property完全一致：为类实例定义访问拦截逻辑，外部代码访问、赋值、删除对应属性时，会自动触发块内定义的getter、setter、deleter方法，对上层Python调用者来说，和普通实例属性、Python原生property的使用体验没有区别。
典型写法示例：

cdef class Token:
    property lemma:
        def __get__(self):
            # 直接操作底层C结构返回属性值，无额外Python层调用开销
            return self._c_struct.lemma.decode("utf8")
        def __set__(self, val):
            raise AttributeError("lemma为只读属性")

与@property语法的核心区别 #

• 适用范围不同：property my_property:是Cython专属语法，只能写在.pyx文件的cdef class块内，纯Python环境下执行会直接触发语法错误；@property是Python标准语法，纯Python类、普通Cython类均可使用。
• 性能表现不同：Cython专属property语法支持直接读写底层C内存结构，会被Cython编译器优化为C级函数调用，跳过Python方法栈的开销，属性访问速度远高于Python原生@property，这也是spaCy这类高性能计算库大规模使用该语法的核心原因。
• 代码组织方式不同：@property采用装饰器拆分写法，getter、setter需要分别加装饰器独立定义；Cython的块级property语法会把同一个属性的所有访问逻辑收拢在同一个缩进块下，代码结构更集中。

提示：如果后续遇到.pyx、.pxd后缀的源码文件，优先查阅Cython相关语法说明，不要直接参考纯Python的语法规则。

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