求助：Kivy对象pickle序列化报错，无法pickle hands_screen对象

为什么会出现这个错误？ #

Kivy的Screen（以及所有Widget子类，比如你这里的hands_screen）内部包含大量和UI上下文相关的引用——比如父组件、屏幕管理器、图形画布、事件绑定等等。这些对象要么存在循环引用，要么是依赖操作系统的底层资源（比如窗口句柄），而Pickle只能处理纯Python数据对象或者实现了Pickle协议的类，Kivy的UI组件并没有设计成可序列化的，所以会抛出TypeError: can't pickle hands_screen objects。

最推荐的解决方案：分离数据与UI #

这是开发中最合理的做法：把需要保存的业务数据从UI组件中抽离出来，单独维护一个纯数据模型，只序列化这个数据模型，而不是整个UI对象。

举个具体的实现例子：

1. 先定义一个纯数据类（可以用Python的dataclasses简化编写），用来存储你需要保存的业务数据：

from dataclasses import dataclass
import pickle

# 定义纯数据类，只包含需要保存的业务属性
@dataclass
class HandData:
    name: str
    player_scores: dict
    current_hand: list
    # 这里添加你实际需要保存的所有数据字段

2. 在你的hands_screen类中，把业务数据存到这个数据模型对象里，而不是直接存在UI组件上：

class hands_screen(Screen):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        # 初始化数据模型
        self.hand_data = HandData(
            name="default_hand",
            player_scores={"player1": 0, "player2": 0},
            current_hand=[]
        )
        # 其他UI初始化逻辑...

3. 序列化的时候，只保存这个数据模型对象：

class ranges_app(App):
    # ... 其他方法 ...
    def on_stop(self):
        app = App.get_running_app()
        f = app.root.manager.utg
        print(f.name)
        # 现在序列化的是纯数据对象，而不是UI组件
        self.pickle_object(f.name, f.h.hand_data)

这样Pickle就能正常工作，因为纯数据类没有任何UI相关的不可序列化引用。

备选方案：自定义Pickle协议（不推荐） #

如果你真的需要序列化UI组件的部分状态（不建议，容易导致UI异常），可以在hands_screen类中实现__getstate__和__setstate__方法，手动控制哪些属性被序列化，排除掉不可Pickle的UI相关属性：

class hands_screen(Screen):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        # 你的自定义属性（需要保存的）
        self.my_custom_data = "需要保存的内容"
        self.some_value = 123

    def __getstate__(self):
        # 复制当前对象的属性字典
        state = self.__dict__.copy()
        # 删除所有不可Pickle的UI相关属性
        # 注意：Kivy组件的内部属性可能很多，需要根据实际情况调整
        for key in ['parent', 'manager', 'canvas', '_children', '_events']:
            if key in state:
                del state[key]
        return state

    def __setstate__(self, state):
        # 恢复属性
        self.__dict__.update(state)
        # 注意：恢复后UI组件的上下文（比如parent、manager）需要手动重新关联，否则UI可能无法正常工作

⚠️ 注意：这种方法风险很高，因为Kivy的UI组件有大量内部状态，手动删除属性可能导致恢复后的组件无法正常渲染或响应事件，所以只作为万不得已的备选方案。

总结建议 #

• 永远遵循数据与UI分离的设计原则，UI只负责展示数据，业务逻辑和数据单独放在模型类中
• 保存应用状态时，只序列化数据模型，不要尝试序列化任何Kivy的Widget、Screen或App实例
• 如果不确定哪些数据需要保存，可以先梳理清楚你的业务逻辑，把需要持久化的信息单独提取出来

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