本文针对 Python 3.6（尤其是 WSL Ubuntu 下 virtualenv 环境）安装 matplotlib 报错 ERROR: Command errored out with exit status 1、AttributeError: install_layout 等典型编译失败问题，提供从环境诊断、依赖升级到兼容版本安装的一站式解决路径。
本文针对 python 3.6（尤其是 wsl ubuntu 下 virtualenv 环境）安装 matplotlib 报错 `error: command errored out with exit status 1`、`attributeerror: install_layout` 等典型编译失败问题，提供从环境诊断、依赖升级到兼容版本安装的一站式解决路径。
在 Python 3.6 环境中（如 WSL Ubuntu 22.04 + virtualenv -p python3.6）安装 matplotlib 失败，是典型的旧版构建工具链与现代源码不兼容问题。错误日志中反复出现 Building wheel for matplotlib (setup.py) ... error 及 AttributeError: install_layout，根本原因并非 matplotlib 本身不支持 Python 3.6（官方明确支持至 3.6.8），而是其构建过程严重依赖较新版本的 setuptools 和 wheel —— 而 Python 3.6 默认附带的 setuptools 版本过低（常为 ≤40.x），缺少对 install_layout 等 PEP 517/518 构建规范的支持，导致源码编译中断。
✅ 首要且最有效的修复步骤：强制升级构建工具链
请在激活的虚拟环境中执行以下命令（注意使用 python3.6 -m pip 显式指定解释器，避免多版本混淆）：
# 升级核心构建工具（关键！） python3.6 -m pip install -U pip setuptools wheel # 验证升级结果（应显示 setuptools ≥60.0） python3.6 -m pip show setuptools
⚠️ 注意：仅运行
pip install -U setuptools可能因 pip 自身版本过旧而失效；务必使用python3.6 -m pip方式调用，确保升级作用于当前 Python 解释器绑定的 pip。
若上述操作后仍编译失败，说明 Python 3.6.0–3.6.5 等早期小版本存在更深层兼容性缺陷（如缺失 distutils.util.strtobool 或 sys.base_prefix 支持）。此时推荐降级安装已预编译、专为 Python 3.6 优化的 matplotlib 稳定版本：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
# 安装最后广泛支持 Python 3.6 的 matplotlib 3.3.4（含完整 wheel） python3.6 -m pip install "matplotlib==3.3.4" # 同步安装强依赖（避免后续导入报错） python3.6 -m pip install "numpy>=1.19.3,<1.22" "kiwisolver==1.3.2" "Pillow==8.4.0"
? 为什么选择 3.3.4？
立即学习“Python免费学习笔记（深入）”；
- 这是 matplotlib 官方最后一个正式声明支持 Python 3.6 的主版本（v3.3.4 Release Notes）；
- 所有依赖（
kiwisolver,Pillow,freetype,libpng）均有对应 Python 3.6 的预编译 wheel，无需本地编译； - 避免了 v3.4+ 引入的
importlib.metadata等 Python 3.8+ 特性导致的运行时崩溃。
? 补充验证与调试建议
安装完成后，务必在 Python 交互环境中执行以下检查：
import matplotlib
print("Version:", matplotlib.__version__) # 应输出 3.3.4
print("Backend:", matplotlib.get_backend()) # 若为 'agg'，说明无 GUI 后端；需图形显示则安装 tkinter
# 测试基础绘图（非交互式）
import matplotlib.pyplot as plt
plt.figure()
plt.plot([1, 2, 3], [1, 4, 2])
plt.savefig("/tmp/test_plot.png") # 成功生成即表明核心功能正常
print("✅ Plot saved to /tmp/test_plot.png")? 进阶提示：WSL 图形显示问题
若需弹出图形窗口（如 plt.show()），需额外配置：
- Ubuntu 端安装
python3-tk：sudo apt update && sudo apt install python3-tk - Windows 端启用 WSLg（Windows 11）或安装 X Server（如 VcXsrv），并在 WSL 中设置：
export DISPLAY=:0
总结：Python 3.6 下 matplotlib 安装失败，90% 源于 setuptools 过旧或版本错配。牢记三步法——先升构建工具，再装兼容版本，最后验功能闭环——即可彻底规避编译陷阱，稳定启用数据可视化能力。
