直接安装预编译wheel包最稳妥：先升级pip，再尝试安装；若失败则从Gohlke库手动下载对应版本.whl安装，避免安装Visual Studio Build Tools。
pip install matplotlib 时提示“Microsoft Visual C++ 14.0 is required”
这是 Windows 上最常见报错，本质是 matplotlib 的某些底层依赖（比如 kiwisolver 或 pybind11）需要编译 C/C++ 扩展，而系统缺少对应构建工具。
- 直接安装预编译的 wheel 包最稳妥：确保 pip 是最新版，再重试
python -m pip install --upgrade pip，然后运行pip install matplotlib - 如果仍失败，手动下载对应 Python 版本和架构（如 cp39-win_amd64）的
matplotlib‑*.whl文件，从 Gohlke 的非官方二进制库 获取，再用pip install xxx.whl安装 - 不推荐强行装 Visual Studio Build Tools——太重，且容易和已有环境冲突
conda install matplotlib 成功但 import 失败，报 “No module named ‘PyQt5.sip’”
这说明 conda 安装的 matplotlib 默认后端依赖 PyQt5，但 PyQt5 和 PyQt6、PySide2/6 混用或版本不匹配时会出问题。
- 先检查后端配置：
import matplotlib; print(matplotlib.get_backend())，常见错误后端是Qt5Agg但没装PyQt5 - 快速修复：改用无 GUI 后端，运行
import matplotlib; matplotlib.use('Agg')（必须在import matplotlib.pyplot之前） - 若需交互绘图，统一环境：用
conda install pyqt（conda 自带的 PyQt5）或conda install pyside2，避免混用 pip 和 conda 安装的 Qt 库
Linux/macOS 下 pip install matplotlib 提示 “freetype” 或 “png” 相关编译错误
这类错误不是 Python 问题，而是系统缺少底层图形库开发头文件，pip 尝试从源码编译时失败。
- Ubuntu/Debian：运行
sudo apt-get install libfreetype6-dev libpng-dev libjpeg-dev - macOS（M1/M2）：用 Homebrew 安装
brew install freetype libpng jpeg，再确认pkg-config --exists freetype2能返回成功 - 跳过编译：加
--only-binary=matplotlib参数强制用 wheel，例如pip install --only-binary=matplotlib matplotlib
虚拟环境中 import matplotlib 正常，但 Jupyter Notebook 里报 ModuleNotFoundError
Jupyter 可能没使用你当前激活的虚拟环境内核，而是用了系统 Python 或其他 kernel。
立即学习“Python免费学习笔记（深入）”；
- 检查当前 kernel：在 notebook 中运行
import sys; print(sys.executable)，看路径是否指向你的 venv - 重新注册内核：
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"，然后在 notebook 顶部菜单 Kernel → Change kernel 里选对 - 别用
pip install jupyter在 base 环境装——它可能把 kernel 绑定到 base，后续在 venv 里装 matplotlib 就白装了
