使用PyWaffle的icons参数为何触发UserWarning并生成异常图标？

问题分析 #

使用icons参数绘制华夫饼图时触发Tight layout not applied警告且图表异常，但characters参数可正常工作，核心原因是**icons依赖Font Awesome字体，而环境中未正确配置该字体，导致图标渲染失败并引发布局计算错误**。

解决方案 #

1. 安装Font Awesome字体依赖 #

首先通过pip安装官方字体包：

pip install fontawesomefree

2. 调整代码配置 #

修改代码，增大画布尺寸、适配图标大小，并关闭自动tight layout以避免警告：

from pywaffle import Waffle
import matplotlib.pyplot as plt

# 数据
value = [12, 22, 16, 38, 12]

# 绘制华夫饼图
plt.figure(
    FigureClass=Waffle,
    rows=10,
    columns=10,
    values=value,
    icons='face-smile',
    figsize=(8, 8),  # 增大画布，给图标预留足够显示空间
    icon_size=12,    # 调整图标尺寸，适配画布布局
    tight_layout=False  # 关闭自动tight layout，规避布局计算警告
)

plt.show()

3. 备选方案：手动指定Font Awesome字体 #

若上述方法仍不生效，可手动指定字体路径确保matplotlib识别：

from pywaffle import Waffle
import matplotlib.pyplot as plt
import matplotlib.font_manager as fm

# 查找并加载Font Awesome字体
font_props = fm.FontProperties(family='Font Awesome 6 Free')
plt.rcParams['font.family'] = font_props.get_name()

value = [12, 22, 16, 38, 12]

plt.figure(
    FigureClass=Waffle,
    rows=10,
    columns=10,
    values=value,
    icons='face-smile',
    figsize=(8, 8)
)

plt.show()

原理说明 #

• characters参数使用系统默认字体支持的普通字符，无需额外依赖，因此渲染正常。
• icons参数依赖Font Awesome图标字体，若字体未安装或未被matplotlib识别，会导致图标无法正确绘制，进而触发布局计算错误，出现tight layout警告。

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