子类化Peewee字段类型扩展功能：示例需求与疑问

当然可以通过子类化Peewee的TextField（或CharField）来实现这个需求，而且不需要完全按照最复杂的自定义字段文档来操作——毕竟我们只是需要添加序列化/反序列化逻辑，复用已有字段的存储能力就足够了。

关于field_type的说明 #

子类化TextField时，你完全可以不用手动设置这个属性，因为父类TextField已经把它定义为'TEXT'了。如果非要显式声明的话，直接赋值为'TEXT'就行，和父类保持一致，这样数据库层面会创建对应类型的字段。

完整子类化示例 #

下面是一个实用的示例，我们用JSON来处理嵌套列表的序列化/反序列化（JSON对嵌套结构的支持非常友好，实现成本也低）：

import json
from peewee import TextField, Model, SqliteDatabase

# 示例用SQLite数据库，你可以换成自己的数据库类型
db = SqliteDatabase('nested_lists.db')

class ListOfListsField(TextField):
    # 可选：显式指定field_type，和父类保持一致
    field_type = 'TEXT'

    def db_value(self, value):
        # 将Python嵌套列表转换为数据库可存储的JSON字符串
        if value is None:
            return None
        return json.dumps(value)

    def python_value(self, value):
        # 将数据库返回的JSON字符串还原为Python嵌套列表
        if value is None:
            return None
        return json.loads(value)

# 定义使用自定义字段的模型
class NestedDataModel(Model):
    nested_lists = ListOfListsField()

    class Meta:
        database = db

# 初始化表（首次运行时执行）
db.create_tables([NestedDataModel])

# 测试存储与读取
test_data = [[1, 'apple', True], [2, 'banana', False], [3, 'cherry', None]]
new_entry = NestedDataModel.create(nested_lists=test_data)
retrieved_entry = NestedDataModel.get_by_id(new_entry.id)

print(retrieved_entry.nested_lists)  # 输出: [[1, 'apple', True], [2, 'banana', False], [3, 'cherry', None]]
print(type(retrieved_entry.nested_lists))  # 输出: <class 'list'>

额外注意事项 #

如果你考虑用CharField替代TextField，一定要留意它的max_length限制——嵌套列表序列化后的字符串长度很容易超过默认的255字符，导致数据被截断。因此更推荐用TextField存储这类可变长度的结构化数据。

关于自定义字段文档的疑问 #

回到你的问题：是否必须按照创建自定义类型的文档说明来实现？其实不用走完全部流程。自定义字段文档里的步骤更多是针对完全从零实现的字段（比如数据库原生不支持的特殊类型），而我们是基于已有的TextField子类化，只需要重写db_value和python_value这两个方法来处理数据转换就够了，父类已经帮我们处理了字段在数据库中的创建、存储、读取等核心逻辑。

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