Pandas-AI 中文显示问题与 Matplotlib 字体配置指南

问题背景

在使用 Pandas-AI 与 Streamlit 结合进行数据可视化时，许多中文用户遇到了图表无法正确显示中文字符的问题。这是一个典型的 Matplotlib 字体配置问题，在数据分析和可视化领域非常常见。

问题现象

当用户使用 Pandas-AI 的 Agent 生成包含中文标签的图表时，中文字符会显示为方框或乱码。这主要是因为 Matplotlib 默认的字体库不包含中文字体支持。

根本原因分析

Matplotlib 作为 Python 最流行的可视化库之一，其默认配置针对的是英文字符集。当系统尝试渲染中文字符时，如果没有正确配置中文字体，就会出现显示异常。

解决方案

基础解决方案

要解决这个问题，需要在生成图表前正确配置 Matplotlib 的字体设置：

import matplotlib.pyplot as plt

# 设置中文字体
plt.rcParams['font.sans-serif'] = ['SimHei']  # 使用黑体显示中文
plt.rcParams['axes.unicode_minus'] = False    # 解决负号显示问题

系统级字体安装

在 Ubuntu 系统上，需要额外安装中文字体：

1. 安装字体包：

sudo apt-get install fonts-wqy-microhei fonts-wqy-zenhei

2. 清除 Matplotlib 缓存：

rm -rf ~/.cache/matplotlib

在 Windows 系统上，确保系统中已安装 SimHei 等中文字体。

高级配置建议

对于生产环境，建议采用更全面的字体配置方案：

import matplotlib as mpl
import matplotlib.pyplot as plt

# 设置全局字体
mpl.rcParams['font.family'] = 'sans-serif'
mpl.rcParams['font.sans-serif'] = ['SimHei', 'Microsoft YaHei', 
                                  'WenQuanYi Micro Hei', 
                                  'Noto Sans CJK SC']
mpl.rcParams['axes.unicode_minus'] = False

常见问题扩展

布局相关错误

在使用过程中，用户可能会遇到以下 Matplotlib 错误：

• AttributeError: 'tight_layout' is not allowed in RestrictedMatplotlib
• AttributeError: 'subplots_adjust' is not allowed in RestrictedMatplotlib

这些错误通常是由于 Pandas-AI 的安全限制导致的。解决方案包括：

1. 简化图表复杂度
2. 调整图表尺寸而非依赖自动布局
3. 分多次查询获取不同维度的图表

最佳实践建议

1. 预处理数据：在生成图表前，确保数据中的中文内容已经正确清洗和处理
2. 图表类型选择：对于包含大量中文标签的数据，优先考虑条形图而非饼图
3. 缓存管理：在长期运行的服务中，定期清理 Matplotlib 缓存
4. 备选方案：考虑使用 Plotly 等对中文支持更好的可视化库

总结

Pandas-AI 的中文显示问题本质上是 Matplotlib 的字体配置问题。通过正确的字体设置和系统配置，可以完美解决中文显示异常的问题。对于更复杂的布局问题，建议调整图表设计或考虑使用其他可视化方案。

对于数据分析师和开发者来说，掌握这些配置技巧不仅能解决 Pandas-AI 的问题，也能应用于其他基于 Matplotlib 的数据可视化场景中，是 Python 数据分析的重要技能之一。