【Python】绘图文字显示异常技术文档

一、背景说明

使用Python绘图库（如Matplotlib）生成图表时，可能出现标题、坐标轴标签、图例等文字显示为方框、空白或缺失的情况，影响图表可读性。本文档针对该问题分析原因并提供解决方案。

二、问题原因及解决方法

2.1 中文显示异常

原因：Matplotlib默认字体不支持中文，导致中文内容无法正确渲染。
解决方法：
配置支持中文的字体，代码如下：

import matplotlib.pyplot as plt  
from matplotlib import rcParams  

# 设置中文字体（需选择系统已安装的字体）  
rcParams['font.family'] = 'SimHei'  # 黑体，可替换为SimSun（宋体）、Kaiti（楷体）等  
rcParams['font.sans-serif'] = ['SimHei']  
rcParams['axes.unicode_minus'] = False  # 确保负号正常显示  

# 绘图并添加中文标签  
plt.bar([1, 2, 3], [10, 20, 15])  
plt.title("图表标题")  
plt.xlabel("横轴标签")  
plt.ylabel("纵轴标签")  
plt.show()  

2.2 未设置图表文字元素

原因：代码中未调用设置标题、标签等文字元素的函数。
解决方法：
在绘图代码中添加文字元素设置：

import matplotlib.pyplot as plt  

# 绘图  
plt.plot([1, 2, 3], [4, 5, 6])  
# 添加标题  
plt.title("折线图示例")  
# 添加坐标轴标签  
plt.xlabel("X轴")  
plt.ylabel("Y轴")  
# 添加图例（若有）  
plt.legend(["数据曲线"])  
plt.show()  

2.3 标签内容为空或数据错误

原因：给标题、标签等赋值的内容为空，或数据处理时标签数据丢失。
解决方法：
检查标签内容赋值，确保有有效文字内容：

import matplotlib.pyplot as plt  

categories = ["类别A", "类别B", "类别C"]  # 确保标签列表有内容  
values = [12, 15, 10]  

plt.bar(categories, values)  
plt.title("分类数据展示")  
plt.xlabel("分类")  
plt.ylabel("数值")  
plt.show()  

2.4 绘图后端渲染问题

原因：绘图后端异常导致文字渲染失败。
解决方法：
尝试更换Matplotlib绘图后端：

import matplotlib  
matplotlib.use('Qt5Agg')  # 更换为其他后端，如'TkAgg'  
import matplotlib.pyplot as plt  

plt.plot([1, 2], [3, 4])  
plt.title("测试标题")  
plt.show()  

三、完整示例代码

import matplotlib.pyplot as plt  
from matplotlib import rcParams  

# 解决中文显示问题  
rcParams['font.family'] = 'SimHei'  
rcParams['font.sans-serif'] = ['SimHei']  
rcParams['axes.unicode_minus'] = False  

# 构造数据  
x = [1, 2, 3, 4]  
y = [10, 20, 15, 25]  

# 绘图并设置文字元素  
plt.bar(x, y)  
plt.title("柱状图示例")  
plt.xlabel("横轴数据")  
plt.ylabel("纵轴数值")  
plt.show()