Python合并多个类装饰器后如何实现PyCharm与原生@dataclass一致的补全行为

PyCharm无法识别自定义装饰器的dataclass行为，是因为IDE没有将你的@api_type标记为具备dataclass转换能力的装饰器，可通过两种方式补全元数据配置：

方案1：使用标准dataclass_transform标记（推荐，跨IDE兼容） #

这是PEP 681定义的标准能力，Python 3.11及以上可以直接从typing导入，更低版本需要先安装typing-extensions依赖，从typing_extensions导入。
只需要给你的api_type装饰器加上@dataclass_transform()装饰即可，修改后代码如下：

# 3.11+ 用 from typing import dataclass_transform
from typing_extensions import dataclass_transform
from dataclasses import dataclass
from serde import deserialize, serialize

@dataclass_transform()
def api_type(cls):
    wrapper = dataclass(cls)
    wrapper = deserialize(wrapper, rename_all='camelcase')
    wrapper = serialize(wrapper, rename_all='camelcase')
    return wrapper

加完后所有主流IDE（PyCharm、VS Code等）都能识别到@api_type装饰的类和原生@dataclass有相同的类行为，自动提示构造参数、补全类属性。两种方案都不会影响原有装饰器的运行逻辑，仅给IDE补充识别用的元数据，运行时无额外开销。

方案2：PyCharm专属标记（兼容老版本PyCharm） #

如果不想额外引入依赖，可以直接给api_type函数的文档字符串添加PyCharm专属的识别标记：

def api_type(cls):
    """
    合并dataclass、序列化、反序列化能力的API类型装饰器
    @pycharm.dataclass
    """
    wrapper = dataclass(cls)
    wrapper = deserialize(wrapper, rename_all='camelcase')
    wrapper = serialize(wrapper, rename_all='camelcase')
    return wrapper

加完重启PyCharm或者等待索引刷新后，就可以正常触发自动补全和参数提示。

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