你遇到的 **Python 绘图（matplotlib）中汉字显示为方框（□□□）**，是经典的 **中文字体缺失 + matplotlib 默认字体不支持中文** 问题。根本原因是： ✅ `matplotlib` 默认使用英文字体（如 `DejaVu Sans`），该字体**不含中文字符集（CJK）**，遇到中文字符串（如标题 `"原始波形图"`）时无法渲染，就用方框 `□` 占位。 --- ### ✅ 一键永久解决方案（推荐，适用于 Windows/macOS/Linux） #### ✅ 步骤 1：查找并安装一个支持中文的系统字体（推荐「思源黑体」或系统自带） | 系统 | 推荐字体 | 获取方式 | |------|-----------|-----------| | **Windows** | `SimHei`（微软雅黑）、`Microsoft YaHei`、`KaiTi`（楷体） | 系统自带，无需安装 | | **macOS** | `Heiti SC`（黑体-简）、`STHeiti`、`PingFang SC` | 系统自带 | | **Linux (Ubuntu/Debian)** | `Noto Sans CJK SC`（思源黑体简体） | `sudo apt install fonts-noto-cjk` | | **通用跨平台（强烈推荐）** | **[思源黑体（Noto Sans CJK）](https://github.com/googlefonts/noto-cjk)** | [下载 .ttf 文件](https://github.com/googlefonts/noto-cjk/releases) → 解压后手动安装 | > 💡 验证字体是否可用（在 Python 中）： > ```python > import matplotlib.font_manager as fm > # 列出所有含"sim"、"hei"、"kai"、"noto"、"heiti"的字体（Windows/macOS/Linux通用） > fonts = [f.name for f in fm.fontManager.ttflist if any(kw in f.name.lower() for kw in ['sim', 'hei', 'kai', 'noto', 'heiti', 'sans'])] > print("✅ 可用中文字体：", sorted(set(fonts))) > ``` --- #### ✅ 步骤 2：配置 matplotlib 使用中文字体（3 种方式，按优先级推荐） ##### ✅ 方式 A：**全局配置（推荐！一劳永逸，写一次，永久生效）** 在你的 Python 脚本**最开头**（或在 `~/.matplotlib/matplotlibrc` 配置文件中）添加： ```python import matplotlib.pyplot as plt import matplotlib # 👇 设置中文字体（以 Windows 的 'SimHei' 为例；macOS 用 'Heiti SC'；Linux 用 'Noto Sans CJK SC'） plt.rcParams['font.sans-serif'] = ['SimHei', 'Arial Unicode MS', 'DejaVu Sans', 'Bitstream Vera Sans'] # 优先级列表 plt.rcParams['axes.unicode_minus'] = False # 解决负号 '-' 显示为方块的问题（关键！） ``` ✅ **说明**： - `'font.sans-serif'`：指定无衬线字体候选列表，matplotlib 会从左到右尝试，第一个存在的即被使用； - `'axes.unicode_minus=False'`：**必须设置！** 否则负号（如 `-5`）会变成方框（因某些中文字体不包含 Unicode 减号 U+2212，而用 ASCII 减号 `-` 替代）。 > ✅ 效果：此后所有 `plt.title()`、`plt.xlabel()`、`plt.text()` 中的中文均正常显示。 --- ##### ✅ 方式 B：**单次绘图临时设置（适合快速调试）** ```python import matplotlib.pyplot as plt # 仅对当前 figure 生效 plt.figure() plt.title("测试中文标题", fontfamily='SimHei') # 指定单个元素字体 plt.xlabel("时间 (秒)", fontfamily='SimHei') plt.ylabel("幅度", fontfamily='SimHei') plt.show() ``` > ⚠️ 缺点：每处中文都要加 `fontfamily=`，代码冗余；不解决负号问题。 --- ##### ✅ 方式 C：**修改 matplotlib 配置文件（永久系统级）** 1. 找到 matplotlib 配置目录： ```python import matplotlib print(matplotlib.matplotlib_fname()) # 输出类似：/path/to/matplotlib/mpl-data/matplotlibrc ``` 2. 用文本编辑器打开该 `matplotlibrc` 文件； 3. 修改以下两行（取消注释并填写）： ```ini font.sans-serif: SimHei, Microsoft YaHei, Noto Sans CJK SC, WenQuanYi Zen Hei, DejaVu Sans, Bitstream Vera Sans axes.unicode_minus: False ``` 4. 保存，重启 Python 内核（Jupyter 需 `Kernel → Restart`）。 ✅ 优势：全环境生效（包括 Jupyter、PyCharm、脚本）；✅ 缺点：需手动编辑配置文件。 --- ### ✅ 完整修复示例（整合进你的波形/MFCC 绘图代码） 只需在你原有代码**最顶部**插入以下 4 行： ```python import matplotlib.pyplot as plt import matplotlib # —— 🔑 中文支持关键配置 —— plt.rcParams['font.sans-serif'] = ['SimHei', 'Heiti SC', 'Noto Sans CJK SC', 'Arial Unicode MS'] plt.rcParams['axes.unicode_minus'] = False # ———————————————— ``` 然后你原来的中文标题（如 `plt.title("🔊 原始语音波形图")`）就能完美显示！ --- ### 🧪 快速验证是否成功？ ```python import matplotlib.pyplot as plt plt.figure(figsize=(6, 2)) plt.text(0.5, 0.5, "你好，世界！✅ 1+1=2，α=0.97", ha='center', va='center', fontsize=16) plt.axis('off') plt.show() ``` ✅ 正确效果：显示“你好，世界！✅ 1+1=2，α=0.97”，无方框，负号和希腊字母正常。 ❌ 失败表现：`"你好"` 显示为 `□□`，`-` 显示为 `□`。 --- ### 📌 常见陷阱与避坑指南 | 问题 | 原因 | 解决方案 | |------|------|-----------| | **仍显示方框** | 字体名拼写错误（如 `'Simhei'` 少了大写 `H`）或系统无此字体 | 运行 `print([f.name for f in fm.fontManager.ttflist])` 查看真实字体名 | | **负号 `-` 变方框** | 忘记设置 `axes.unicode_minus: False` | ✅ 必加！这是独立于字体的底层渲染开关 | | **Jupyter 中不生效** | 内核未重启 | 修改 `matplotlibrc` 或代码后，务必 `Kernel → Restart & Run All` | | **PyCharm 绘图窗口乱码** | PyCharm 终端/SciView 使用了不同 backend | 在代码开头加 `plt.switch_backend('Agg')`（非交互）或改用 `Qt5Agg` backend | > ✅ PyCharm 用户额外建议： > `File → Settings → Tools → Python Scientific → Backend` → 改为 `Qt5Agg`（需安装 `PyQt5`：`pip install PyQt5`） ---