Matplotlib中文图表制作全攻略从字体配置到乱码解决一步到位掌握专业数据可视化技巧让图表更加直观易懂

引言

Matplotlib是Python中最流行的数据可视化库之一，它提供了丰富的绘图功能，能够创建各种静态、动态和交互式的图表。然而，对于中文用户来说，Matplotlib的默认设置往往无法正确显示中文字符，导致图表中的中文显示为方框或乱码，这给数据分析和展示带来了不小的困扰。本文将全面介绍Matplotlib中文显示的解决方案，从基础的字体配置到高级的可视化技巧，帮助您一步到位掌握专业数据可视化技能，让您的图表更加直观易懂。

Matplotlib中文显示问题的根源

在深入解决方案之前，我们首先需要了解为什么Matplotlib默认情况下无法正确显示中文字符。这主要有以下几个原因：

默认字体不支持中文：Matplotlib的默认字体（如DejaVu Sans）主要针对西方字符设计，不包含中文字符集。
字符编码问题：Python 2时代遗留下来的编码问题，以及不同操作系统对中文字符编码的处理方式不同。
字体路径配置：Matplotlib无法自动找到系统中合适的中文字体路径。
渲染引擎限制：Matplotlib的后端渲染引擎对字体的支持程度不同。

了解了这些根本原因后，我们就可以有针对性地解决问题了。

解决方案一：全局字体配置

全局字体配置是最直接的解决方案，通过修改Matplotlib的默认字体设置，使其能够正确显示中文字符。

1. 查看可用字体

首先，我们需要查看系统中可用的字体：

import matplotlib.font_manager as fm # 获取所有可用字体 fonts = fm.findSystemFonts() # 筛选中文字体 chinese_fonts = [f for f in fonts if 'simhei' in f.lower() or 'simsun' in f.lower() or 'microsoft yahei' in f.lower() or 'pingfang' in f.lower()] print("系统中可用的中文字体：") for font in chinese_fonts: print(font)

2. 设置全局字体

找到合适的中文字体后，我们可以通过以下方式设置全局字体：

import matplotlib.pyplot as plt import numpy as np # 设置全局字体 plt.rcParams['font.sans-serif'] = ['SimHei'] # 'SimHei'是黑体 plt.rcParams['axes.unicode_minus'] = False # 解决负号显示问题 # 测试图表 x = np.linspace(0, 10, 100) y = np.sin(x) plt.figure(figsize=(10, 6)) plt.plot(x, y, label='正弦曲线') plt.title('正弦函数图像') plt.xlabel('x轴') plt.ylabel('y轴') plt.legend() plt.grid(True) plt.show()

3. 字体配置文件修改

另一种全局配置方法是修改Matplotlib的配置文件matplotlibrc。首先，找到配置文件的位置：

import matplotlib # 获取matplotlib配置文件路径 print(matplotlib.matplotlib_fname())

然后，编辑该文件，找到以下行并修改：

font.sans-serif : SimHei, DejaVu Sans, Bitstream Vera Sans, ... axes.unicode_minus : False

解决方案二：局部字体配置

全局配置虽然简单，但有时会影响所有图表。局部字体配置则更加灵活，可以针对特定图表或文本元素设置字体。

1. 使用FontProperties

import matplotlib.pyplot as plt import matplotlib.font_manager as fm import numpy as np # 创建字体属性 font_path = 'C:/Windows/Fonts/simhei.ttf' # Windows系统中的黑体字体路径 font_prop = fm.FontProperties(fname=font_path) # 测试图表 x = np.linspace(0, 10, 100) y = np.sin(x) plt.figure(figsize=(10, 6)) plt.plot(x, y, label='正弦曲线') plt.title('正弦函数图像', fontproperties=font_prop) plt.xlabel('x轴', fontproperties=font_prop) plt.ylabel('y轴', fontproperties=font_prop) plt.legend(prop=font_prop) plt.grid(True) plt.show()

2. 直接指定字体名称

import matplotlib.pyplot as plt import numpy as np # 测试图表 x = np.linspace(0, 10, 100) y = np.sin(x) plt.figure(figsize=(10, 6)) plt.plot(x, y, label='正弦曲线') plt.title('正弦函数图像', fontname='SimHei') plt.xlabel('x轴', fontname='SimHei') plt.ylabel('y轴', fontname='SimHei') plt.legend(prop={'family': 'SimHei'}) plt.grid(True) plt.show()

解决方案三：使用中文字体缓存

Matplotlib支持字体缓存机制，通过重建字体缓存，可以使其识别新安装的字体。

1. 删除字体缓存

首先，删除Matplotlib的字体缓存：

import matplotlib # 获取字体缓存目录 cache_dir = matplotlib.get_cachedir() print(f"字体缓存目录: {cache_dir}") # 删除字体缓存（需要手动操作） # 在Windows系统中，通常是 %USERPROFILE%.matplotlib # 在Linux/Mac系统中，通常是 ~/.matplotlib

2. 重建字体缓存

删除缓存后，下次运行Matplotlib时会自动重建字体缓存。也可以手动重建：

import matplotlib.font_manager as fm # 重建字体缓存 fm._rebuild()

解决方案四：使用Seaborn辅助设置

Seaborn是基于Matplotlib的高级可视化库，它提供了更简单的中文字体设置方法。

import seaborn as sns import matplotlib.pyplot as plt import numpy as np # 设置Seaborn样式和中文字体 sns.set(style="whitegrid", font="SimHei") # 测试图表 x = np.linspace(0, 10, 100) y = np.sin(x) plt.figure(figsize=(10, 6)) plt.plot(x, y, label='正弦曲线') plt.title('正弦函数图像') plt.xlabel('x轴') plt.ylabel('y轴') plt.legend() plt.show()

常见中文字体配置示例

不同的中文字体有不同的特点和适用场景，下面是一些常见中文字体的配置示例：

1. 黑体（SimHei）

黑体是一种无衬线字体，适合用于标题和标签：

import matplotlib.pyplot as plt import numpy as np plt.rcParams['font.sans-serif'] = ['SimHei'] plt.rcParams['axes.unicode_minus'] = False x = np.arange(1, 13) y = np.array([120, 150, 180, 220, 260, 300, 320, 350, 380, 420, 450, 480]) plt.figure(figsize=(10, 6)) plt.bar(x, y, color='skyblue') plt.title('2023年月度销售额统计', fontsize=16) plt.xlabel('月份', fontsize=12) plt.ylabel('销售额（万元）', fontsize=12) plt.xticks(x, [f'{i}月' for i in range(1, 13)]) plt.grid(axis='y', linestyle='--', alpha=0.7) plt.show()

2. 宋体（SimSun）

宋体是一种衬线字体，适合用于正文和详细说明：

import matplotlib.pyplot as plt import numpy as np plt.rcParams['font.sans-serif'] = ['SimSun'] plt.rcParams['axes.unicode_minus'] = False categories = ['产品A', '产品B', '产品C', '产品D', '产品E'] values = [25, 30, 15, 20, 10] explode = [0, 0.1, 0, 0, 0] # 突出显示第二块 plt.figure(figsize=(10, 8)) plt.pie(values, explode=explode, labels=categories, autopct='%1.1f%%', shadow=True, startangle=90) plt.title('产品销售占比分析', fontsize=16) plt.axis('equal') # 保证饼图是圆的 plt.show()

3. 微软雅黑（Microsoft YaHei）

微软雅黑是一种现代无衬线字体，适合用于各种图表：

import matplotlib.pyplot as plt import numpy as np import pandas as pd plt.rcParams['font.sans-serif'] = ['Microsoft YaHei'] plt.rcParams['axes.unicode_minus'] = False # 创建示例数据 np.random.seed(0) dates = pd.date_range('20230101', periods=12) values_A = np.random.randint(50, 200, size=12) values_B = np.random.randint(30, 150, size=12) plt.figure(figsize=(12, 6)) plt.plot(dates, values_A, 'o-', label='产品A销量') plt.plot(dates, values_B, 's-', label='产品B销量') plt.title('2023年产品销量趋势对比', fontsize=16) plt.xlabel('日期', fontsize=12) plt.ylabel('销量（件）', fontsize=12) plt.legend() plt.grid(True, linestyle='--', alpha=0.7) plt.xticks(rotation=45) plt.tight_layout() plt.show()

高级技巧：自定义字体样式

除了基本的中文字体设置，我们还可以进一步自定义字体样式，使图表更加专业和美观。

1. 字体大小和颜色

import matplotlib.pyplot as plt import numpy as np plt.rcParams['font.sans-serif'] = ['SimHei'] plt.rcParams['axes.unicode_minus'] = False x = np.linspace(0, 10, 100) y = np.sin(x) plt.figure(figsize=(12, 6)) plt.plot(x, y, 'b-', linewidth=2, label='正弦曲线') plt.title('正弦函数图像', fontsize=20, color='#333333') plt.xlabel('x轴', fontsize=14, color='#666666') plt.ylabel('y轴', fontsize=14, color='#666666') plt.legend(fontsize=12) plt.grid(True, linestyle='--', alpha=0.7) plt.tick_params(axis='both', which='major', labelsize=12) plt.show()

2. 多种字体混用

import matplotlib.pyplot as plt import matplotlib.font_manager as fm import numpy as np # 创建不同字体的属性 font_title = fm.FontProperties(fname='C:/Windows/Fonts/simhei.ttf', size=18) font_label = fm.FontProperties(fname='C:/Windows/Fonts/simhei.ttf', size=14) font_text = fm.FontProperties(fname='C:/Windows/Fonts/simsun.ttc', size=12) x = np.linspace(0, 10, 100) y = np.sin(x) plt.figure(figsize=(12, 6)) plt.plot(x, y, 'b-', linewidth=2, label='正弦曲线') plt.title('正弦函数图像', fontproperties=font_title) plt.xlabel('x轴', fontproperties=font_label) plt.ylabel('y轴', fontproperties=font_label) plt.text(5, 0.5, '正弦函数的周期为2π', fontproperties=font_text, ha='center', bbox=dict(facecolor='yellow', alpha=0.2)) plt.legend(prop=font_label) plt.grid(True, linestyle='--', alpha=0.7) plt.show()

3. 自定义字体颜色映射

import matplotlib.pyplot as plt import numpy as np from matplotlib.colors import LinearSegmentedColormap plt.rcParams['font.sans-serif'] = ['SimHei'] plt.rcParams['axes.unicode_minus'] = False # 创建自定义颜色映射 colors = [(0.1, 0.2, 0.5), (0.5, 0.7, 0.9), (1, 0.8, 0.3)] # 蓝色到黄色 cmap_name = 'custom_cmap' cm = LinearSegmentedColormap.from_list(cmap_name, colors, N=100) # 生成示例数据 x = np.random.randn(1000) y = np.random.randn(1000) colors = np.sqrt(x**2 + y**2) plt.figure(figsize=(10, 8)) scatter = plt.scatter(x, y, c=colors, cmap=cm, alpha=0.7) plt.title('二维正态分布散点图', fontsize=16) plt.xlabel('X轴', fontsize=12) plt.ylabel('Y轴', fontsize=12) plt.colorbar(scatter, label='距离原点的距离') plt.grid(True, linestyle='--', alpha=0.3) plt.show()

完整示例：创建专业中文图表

下面是一个综合示例，展示如何创建一个专业的中文图表，包含多种元素和样式：

import matplotlib.pyplot as plt import numpy as np import pandas as pd from matplotlib.ticker import FuncFormatter # 设置全局字体 plt.rcParams['font.sans-serif'] = ['Microsoft YaHei'] plt.rcParams['axes.unicode_minus'] = False # 创建示例数据 np.random.seed(42) months = pd.date_range('20230101', periods=12, freq='M') sales_A = np.random.randint(100, 300, size=12) + np.linspace(10, 100, 12) sales_B = np.random.randint(80, 250, size=12) + np.linspace(5, 80, 12) profit_A = sales_A * np.random.uniform(0.1, 0.3, size=12) profit_B = sales_B * np.random.uniform(0.15, 0.35, size=12) # 创建图表 fig, (ax1, ax2) = plt.subplots(2, 1, figsize=(14, 10), gridspec_kw={'height_ratios': [2, 1]}) # 第一个子图：销售额 ax1.plot(months, sales_A, 'o-', linewidth=2, markersize=8, label='产品A销售额') ax1.plot(months, sales_B, 's-', linewidth=2, markersize=8, label='产品B销售额') ax1.set_title('2023年产品销售额与利润分析', fontsize=18, pad=20) ax1.set_ylabel('销售额（万元）', fontsize=14) ax1.legend(fontsize=12, loc='upper left') ax1.grid(True, linestyle='--', alpha=0.7) # 设置y轴格式 def millions_formatter(x, pos): return f'{x/100:.1f}百万' ax1.yaxis.set_major_formatter(FuncFormatter(millions_formatter)) # 添加数据标签 for i, (month, sale) in enumerate(zip(months, sales_A)): if i % 2 == 0: # 每隔一个标签显示一次，避免过于拥挤 ax1.text(month, sale + 10, f'{sale:.0f}', ha='center', fontsize=10) # 第二个子图：利润率 profit_rate_A = profit_A / sales_A * 100 profit_rate_B = profit_B / sales_B * 100 ax2.bar(months, profit_rate_A, width=15, alpha=0.7, label='产品A利润率') ax2.bar(months, profit_rate_B, width=15, alpha=0.7, label='产品B利润率', bottom=profit_rate_A) ax2.set_xlabel('月份', fontsize=14) ax2.set_ylabel('利润率（%）', fontsize=14) ax2.legend(fontsize=12, loc='upper right') ax2.grid(True, linestyle='--', alpha=0.7, axis='y') # 设置x轴日期格式 ax1.xaxis.set_major_formatter(plt.DateFormatter('%Y-%m')) ax2.xaxis.set_major_formatter(plt.DateFormatter('%Y-%m')) # 调整布局 plt.tight_layout() # 添加注释 fig.text(0.5, 0.01, '数据来源：公司内部销售系统', ha='center', fontsize=10, color='gray') plt.show()

常见问题与解决方案

1. 负号显示为方块

问题：在设置中文字体后，负号可能显示为方块。

解决方案：

plt.rcParams['axes.unicode_minus'] = False # 解决负号显示问题

2. 字体文件路径问题

问题：在不同操作系统中，字体文件路径不同。

解决方案：

import platform import matplotlib.font_manager as fm # 根据操作系统选择字体路径 system = platform.system() if system == 'Windows': font_path = 'C:/Windows/Fonts/simhei.ttf' elif system == 'Darwin': # MacOS font_path = '/System/Library/Fonts/STHeiti Medium.ttc' else: # Linux font_path = '/usr/share/fonts/truetype/droid/DroidSansFallbackFull.ttf' font_prop = fm.FontProperties(fname=font_path)

3. 图表保存时中文显示异常

问题：图表在屏幕上显示正常，但保存为图片后中文显示异常。

解决方案：

import matplotlib.pyplot as plt # 创建图表 plt.figure() plt.plot([1, 2, 3], [4, 5, 6]) plt.title('测试图表') # 保存时指定bbox_inches=tight plt.savefig('test.png', dpi=300, bbox_inches='tight') plt.close()

4. Jupyter Notebook中中文显示问题

问题：在Jupyter Notebook中，即使设置了中文字体，中文仍然显示异常。

解决方案：

# 在Jupyter Notebook中，首先运行以下魔法命令 %matplotlib inline %config InlineBackend.figure_format = 'retina' # 然后设置中文字体 import matplotlib.pyplot as plt plt.rcParams['font.sans-serif'] = ['SimHei'] plt.rcParams['axes.unicode_minus'] = False

5. 特殊字符显示问题

问题：一些特殊中文字符或符号无法正确显示。

解决方案：

import matplotlib.pyplot as plt from matplotlib.font_manager import FontProperties # 使用支持更多字符的字体，如"Microsoft YaHei"或"SimSun" font = FontProperties(fname='C:/Windows/Fonts/msyh.ttc') # 微软雅黑 plt.figure() plt.plot([1, 2, 3], [4, 5, 6]) plt.title('特殊字符测试：α, β, γ, ℃, ℉, Ⅰ, Ⅱ, Ⅲ', fontproperties=font) plt.show()

总结与最佳实践

通过本文的介绍，我们全面了解了Matplotlib中文图表制作的各个方面。以下是一些总结和最佳实践建议：

选择合适的字体：
- 黑体（SimHei）适合标题和标签
- 宋体（SimSun）适合正文和详细说明
- 微软雅黑（Microsoft YaHei）是一种通用性较强的现代字体
配置方法选择：
- 对于需要统一风格的多个图表，使用全局配置
- 对于单个特殊图表，使用局部配置
- 在团队协作中，考虑使用配置文件确保一致性
跨平台兼容性：
- 考虑不同操作系统的字体差异
- 可以将字体文件与代码一起分发，确保环境一致性
性能考虑：
- 避免在循环中频繁创建FontProperties对象
- 对于大量图表生成，考虑预先加载和缓存字体
专业图表设计：
- 注意字体大小、颜色和样式的协调
- 合理使用图表元素，避免过度装饰
- 确保图表的可读性和信息传达效率