Python元类冲突问题求助：拆分类文件触发TypeError报错

问题复现 #

正常运行的单文件结构 #

test.py代码：

import One

One.py代码：

from tkinter import ttk
class One(): pass
class Two(One, ttk.Entry): pass

拆分多文件后报错的结构 #

test.py代码：

import Two

One.py代码：

class One(): pass

Two.py代码：

from tkinter import ttk
import One
class Two(One, ttk.Entry): pass

触发的错误：

TypeError: metaclass conflict: the metaclass of a derived class must be a (non-strict) subclass of the metaclasses of all its bases

运行环境：Python 3.9.7、Lubuntu 21.10

问题根源 #

Python中，子类继承多个父类时，所有父类的元类必须满足兼容关系——要么元类完全相同，要么其中一个元类是另一个的子类。

• 单文件场景下，One类定义在导入ttk之后，Python会自动生成一个兼容两个父类元类的联合元类，所以不会报错。
• 多文件场景下，One类在单独文件中定义，默认元类是type；而ttk.Entry的元类是tkinter.ttk.Metaclass，这两个元类之间没有继承关系，导致元类合并失败，触发冲突报错。

解决办法 #

方案1：让One类使用ttk.Entry的元类 #

修改One.py，显式指定One类的元类与ttk.Entry一致：

from tkinter import ttk

class One(metaclass=type(ttk.Entry)):
    pass

方案2：自定义兼容的联合元类 #

如果需要保留One类的默认元类特性，可以在Two.py中定义一个同时继承两个元类的新元类：

from tkinter import ttk
import One

# 定义兼容两个父类元类的联合元类
class CombinedMeta(type(ttk.Entry), type):
    pass

class Two(One.One, ttk.Entry, metaclass=CombinedMeta):
    pass

方案3：调整继承顺序 #

将ttk.Entry放在继承列表的首位，Python会优先使用它的元类来处理继承：

# 修改Two.py中的类定义
class Two(ttk.Entry, One.One):
    pass

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