Matplotlib画图不显示主因是缺plt.show()或后端冲突；Seaborn catplot与boxplot参数不互通；图例应优先用ax.legend()；中文显示需配置font.sans-serif字体列表并验证系统可用字体。
Matplotlib画图卡在空白窗口或不显示图像
不是代码写错了，大概率是没调用 plt.show() 或后端配置冲突。Jupyter里用 %matplotlib inline 是默认方案，但本地脚本跑完没反应，就是缺这句；如果用了 plt.ion() 又忘了 plt.pause()，窗口会闪退。
常见错误现象：Figure(432x288) 这种对象打印出来、但啥也没弹；或者图像弹出后立刻关闭。
- 脚本中必须以
plt.show()结尾（不能只靠plt.draw()） - Jupyter 里别混用
%matplotlib widget和%matplotlib inline，后者更稳 - 远程服务器上跑图？直接设环境变量
export MPLBACKEND=Agg，否则报TclError: no display name
Seaborn的catplot()和boxplot()传参总报错
核心矛盾在于：Seaborn 0.12+ 把大部分绘图函数拆成「面向数据」和「面向轴」两类。catplot() 是 figure-level，只认 data= + 列名字符串；而 boxplot() 是 axes-level，能接数组、Series，也能接 data= + 字符串——但参数名不互通。
典型报错：TypeError: boxplot() got an unexpected keyword argument 'hue'，其实是你把 catplot() 的写法套到了 boxplot() 上。
立即学习“Python免费学习笔记（深入）”；
-
catplot(x='col1', y='col2', hue='col3', data=df)✅ 正确 -
boxplot(x=df['col1'], y=df['col2'], hue=df['col3'])❌ 错，boxplot()没hue参数 - 要分组箱线图，改用
boxplot(x='col1', y='col2', hue='col3', data=df)（注意：这是 seaborn.boxplot，不是 matplotlib.pyplot.boxplot）
图例位置死活调不对，plt.legend() 和 ax.legend() 行为不一致
根本原因是 Matplotlib 的 legend 默认绑定到当前 active axes，而 Seaborn 绘图后常会新建 axes，导致 plt.legend() 找错目标。更隐蔽的是：plt.legend(loc='upper right') 看似简单，但 loc 值在不同 backend 下解释可能偏差，尤其嵌入 Qt 应用时。
性能影响不大，但兼容性差——比如在某些 Conda 环境下 loc='best' 会卡住几秒才出图。
- 优先用
ax.legend(loc='upper left', bbox_to_anchor=(1, 1))显式指定 axes - Seaborn 图一律用
g._legend.set_bbox_to_anchor((1, 0.5))（g是catplot返回对象） - 避免
plt.legend()在多子图场景下使用，它不保证作用于你刚画的那个子图
中文标签显示方块、字体模糊或粗细异常
Matplotlib 默认不支持中文字体，硬塞中文就会方块；Seaborn 继承这个设定，所以 sns.set(font='SimHei') 不一定生效——它只改 rcParams，不改字体文件路径。
最易被忽略的点：Mac 和 Windows 的字体名完全不同，'SimHei' 在 Mac 上根本不存在，而 'Helvetica' 在 Windows 上又可能 fallback 到 Times New Roman。
- 先查系统可用字体：
from matplotlib.font_manager import fontManager; [f.name for f in fontManager.ttflist if 'sim' in f.name.lower()] - 全局设置推荐用：
plt.rcParams['font.sans-serif'] = ['Arial Unicode MS', 'SimHei', 'DejaVu Sans']（顺序即 fallback 顺序） - 导出 PDF 时中文模糊？关掉
plt.rcParams['pdf.fonttype'] = 42，改用42（TrueType）而非默认的3（Type 3）
字体这事没有一劳永逸的解法，每次换环境都要重新验证可用字体名，别信网上的“万能字体列表”。
