使用dfgui在Kivy展示DataFrame遇断言及类型错误求助

嘿，我来帮你搞定这个问题！首先得说，你用的dfgui这个非官方包本身依赖wxPython，而你是在Kivy环境里运行，两个不同的GUI框架混在一起很容易出冲突，这大概率是你报错的核心原因之一。咱们一步步来梳理：

先说说你遇到的错误原因 #

1. wx断言错误：wx._core.PyAssertionError: C++ assertion "!items.IsEmpty()" failed，这是因为dfgui在尝试往wx的控件里插入数据时，没有拿到有效数据——要么你的DataFrame是空的，要么数据格式和dfgui的预期不匹配。
2. TypeError: String or Unicode type required：这个说明你的DataFrame里存在非字符串/Unicode类型的数据（比如datetime、numpy特殊数值类型），dfgui的wx控件无法直接处理这些类型。

如果你非要用dfgui的临时修复方向（不推荐） #

• 先检查你的数据：确保DataFrame没有空行/空列，把所有数据转成字符串类型试试：

  df = pd.read_excel('Res.xls').astype(str)
  dfgui.show(df)
  

• 检查wxPython版本：dfgui可能只兼容旧版本的wxPython（比如3.0.x），试试降级到对应版本：pip install wxPython==3.0.2.0
• 去dfgui的GitHub仓库看看issues，有没有其他用户遇到同样问题并给出了修复方案

更靠谱的Kivy原生替代方案 #

既然你是在Kivy项目里，优先用适配Kivy生态的工具，完全避免跨GUI框架的冲突：

1. 使用Kivy Garden的DataTables组件（最推荐） #

这是Kivy官方维护的花园组件，专门用来展示表格数据，完美支持DataFrame：

• 先安装组件：

  garden install datatables
  

• 示例代码：

  from kivy.garden.datatables import DataTable
  from kivy.app import App
  import pandas as pd
  
  class DataFrameViewer(App):
      def build(self):
          # 读取Excel数据到DataFrame
          df = pd.read_excel('Res.xls')
          
          # 把DataFrame转换为DataTables需要的格式
          # 定义列：每个列的显示文本和宽度
          table_columns = [{'text': col_name, 'width': 220} for col_name in df.columns]
          # 定义行：把DataFrame的每一行转成列表
          table_rows = [list(row_data) for row_data in df.values]
          
          # 返回DataTable组件作为App的根控件
          return DataTable(columns=table_columns, rows=table_rows)
  
  if __name__ == '__main__':
      DataFrameViewer().run()
  

2. 用RecycleView自定义表格（适合高度定制） #

如果需要更灵活的表格样式（比如排序、编辑、单元格样式），可以用Kivy的核心组件RecycleView自己实现，它专门用来高效展示大量数据：

• 核心思路是把DataFrame的数据转换成RecycleView需要的字典列表数据源，然后配合RecycleBoxLayout和自定义的单元格组件来渲染。

3. 非Kivy嵌入的备选：pandasgui #

如果只是需要快速查看和操作DataFrame，不一定要嵌入Kivy窗口，可以用pandasgui——这是维护非常活跃的工具，支持可视化编辑、筛选、绘图等功能：

• 安装：pip install pandasgui
• 使用：

  import pandas as pd
  import pandasgui
  
  df = pd.read_excel('Res.xls')
  pandasgui.show(df)
  

  它会打开一个独立的Qt窗口来展示数据，操作体验比dfgui好很多。

总结 #

优先选择Kivy原生的datatables组件，完全适配你的Kivy项目，不会有跨GUI框架的冲突问题；如果需要高度定制，就用RecycleView自己实现；如果只是临时查看数据，pandasgui是更省心的选择。

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