尧图网站建设 )
Matplotlib 是一个功能全面的 Python 可视化库用于绘制静态、动画及交互式图表。---# 第一部分 安装## 主流包管理器一键安装### 1. pipbashpip install matplotlib### 2. condabashconda install -c conda-forge matplotlib### 3. pixibashpixi add matplotlib### 4. uvbashuv add matplotlib ⚠️ **警告** uv 会默认安装独立版本 Python源自 python-build-standalone 项目。截至2025年8月仅新版绑定的 Python 才能正常通过 tkagg 后端弹窗显示图表。 1. 将 uv 更新至 0.8.7 及以上版本 bash uv self update 2. 升级内置 Python 运行环境 bash uv python upgrade --reinstall 若仍无法使用 TkAgg 后端可直接安装 Qt 依赖使用其他GUI框架 bash uv add matplotlib pyside6 ### 其他安装方式1. 安装官方发布二进制版本2. 安装社区夜间构建版本3. 从源代码手动编译安装---## 1.1 安装官方发行版Matplotlib 已为 macOS、Windows、Linux 全平台在 PyPI 提供预编译 wheel 安装包推荐使用 pip 安装bash# 先升级pippython -m pip install -U pip# 安装/升级matplotlibpython -m pip install -U matplotlib### 编译安装报错解决方案如果执行上述命令触发源码编译并出现异常添加 --prefer-binary 参数强制使用系统对应预编译包bashpython -m pip install -U matplotlib --prefer-binary### 后端默认支持说明1. 无需额外依赖即可直接使用的非交互式后端Agg、ps、pdf、svg2. TkAgg 交互式后端依赖 Python 标准库 tkinter。部分系统需手动安装系统包如 Debian/Ubuntu 的 python3-tk3. uv 内置 Python 环境在2025年8月之后才完整支持 Tk 绑定异常请执行前文 uv 升级命令。如需启用其他GUI框架、LaTeX公式渲染、动画导出、拓展文件保存格式需手动安装**可选依赖包**。---## 1.2 第三方渠道分发安装### 1.2.1 Conda 渠道安装1. Anaconda 官方主渠道bashconda install matplotlib2. conda-forge 社区开源渠道推荐bashconda install -c conda-forge matplotlib### 1.2.2 内置Matplotlib的Python发行版以下完整版科学计算环境已预装Matplotlib无需手动安装- Anaconda- ActiveState ActivePython- WinPython### 1.2.3 Linux 系统包管理器安装使用操作系统自带Python时直接用系统包管理器安装- Debian / Ubuntubashsudo apt-get install python3-matplotlib- Fedorabashsudo dnf install python3-matplotlib- RedHat/CentOSbashsudo yum install python3-matplotlib- Arch Linuxbashsudo pacman -S python-matplotlib---## 1.3 安装夜间开发构建版本Matplotlib 每日开发版打包托管在 Anaconda Cloud通过 pip 指定私有索引安装bashpython -m pip install --upgrade --pre \--index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple \--extra-index-url https://pypi.org/simple matplotlib---## 1.4 从源代码编译安装### 适用场景1. 需要向 Matplotlib 开源仓库提交代码贡献2. 必须使用尚未正式发布的最新开发分支代码。 ⚠️ 注意普通生产环境**不推荐源码编译**极易出现编译失败、本地单元测试无法通过等问题请优先使用预编译wheel包。### 前置要求编译前必须提前安装全部编译依赖源码包可从PyPI官网下载 tar.gz 压缩包。Windows 下自行打包 wheel/sdist 时源码目录内所有DLL文件都会被一并打入安装包注意清理冗余文件。---## 1.5 编译参数与全局默认行为配置项目根目录下 meson.options 文件可自定义编译行为例如指定默认渲染后端、开关附属可选依赖库编译等主要面向打包分发人员使用。### 1.5.1 环境变量配置核心| 环境变量 | 作用说明 || ---- | ---- || HOME | 用户根目录Linux下 ~ 等价于 $HOME || MPLBACKEND | 指定Matplotlib默认渲染后端详见后端说明文档 || MPLCONFIGDIR | 自定义配置文件与缓存存放目录。未定义时brLinuxHOME/.config/matplotlib配置 HOME/.cache/matplotlib缓存brWindows/macOSHOME/.matplotlibbr无写入权限时自动使用系统临时目录 || MPL_IGNORE_SYSTEM_FONTS | 启用后仅读取库内置字体不再扫描系统字体减少子进程开销 || PATH | 系统可执行文件搜索路径 || PYTHONPATH | Python模块导入额外搜索路径 || QT_API | Qt系列后端指定绑定库PyQt6/PySide6等 |#### Linux / macOS 设置环境变量1. 查看当前变量值bashecho $PYTHONPATH# 查看当前Shell类型echo $SHELL2. 临时设置变量终端生效关闭失效bash# bash / ksh 语法export PYTHONPATH~/Python# csh / tcsh 语法setenv PYTHONPATH ~/Python3. 路径前置/追加bash# 路径前置优先搜索export PATH~/bin:${PATH}setenv PATH ~/bin:${PATH}# 路径末尾追加export PATH${PATH}:~/binsetenv PATH ${PATH}:~/bin4. 永久生效将上述 export / setenv 命令写入对应Shell配置文件- bash~/.bashrc- csh~/.cshrc#### Windows 设置环境变量1. 打开路径控制面板 → 系统 → 高级系统设置 → 环境变量2. 在**用户变量**或**系统变量**中新建/编辑对应变量即可。 补充绘图全局样式、默认参数也可通过 rcParams / matplotlibrc 配置文件修改。---## 1.6 完整依赖清单使用 pip / conda 安装时**强制依赖会自动安装**本节用于排查异常、手动源码编译参考。### 1.6.1 运行时依赖#### 强制核心依赖必须安装- Python ≥ 3.11- contourpy ≥ 1.0.1- cycler ≥ 0.10.0- python-dateutil ≥ 2.7- fontTools ≥ 4.28.2- kiwisolver ≥ 1.3.1- NumPy ≥ 1.25- packaging ≥ 20.0- Pillow ≥ 9.0- pyparsing ≥ 3 Conda 说明 上述依赖被封装在 matplotlib-base 包内其他第三方包请依赖 matplotlib-base 而非直接依赖 matplotlib Conda 官方 matplotlib 元包自带 pyside6 后端开箱可用GUI绘图窗口。#### 可选拓展依赖按需安装##### 1. GUI渲染后端依赖- Tk 库≥8.5排除8.6.0/8.6.1版本TkAgg后端- PyQt6 / PySide6 / PyQt5 / PySide2Qt系列后端- PyGObject pycairo ≥1.14.0GTK后端- pycairo ≥1.14.0 或 cairocffi ≥0.8Cairo矢量渲染后端- wxPython ≥4WxWidgets后端- Tornado ≥5WebAgg网页交互式后端- ipykernelJupyter Notebook nbagg后端- macOS 系统 ≥10.12macOS原生后端##### 2. 动画与导出工具- ffmpeg视频文件导出- ImageMagickGIF动图导出##### 3. 字体与公式渲染- LaTeX配套 cm-super、underscore GhostScript ≥9.0公式文本渲染- fontconfig ≥2.7Linux系统字体自动扫描##### 4. C底层依赖库Matplotlib 内置副本- AggC抗锯齿2D渲染引擎- ttconvTrueType字体解析工具外部系统依赖- FreeType ≥2.3字体光栅化渲染- QHull ≥8.0.2版本别名2020.2几何三角剖分计算库### 使用系统自带FreeType/QHull编译默认安装会自动下载编译内置版本如需强制调用系统已安装库使用以下命令bashpython -m pip install matplotlib \--config-settingssetup-args-Dsystem-freetypetrue \--config-settingssetup-args-Dsystem-qhulltrue#### 步骤1安装系统开发库头文件bash# Debian/Ubuntusudo apt install libfreetype6-dev pkg-config# Fedorasudo dnf install freetype-devel pkgconf# macOS Homebrewbrew install freetype pkg-config# Conda全平台conda install freetype pkg-config#### 步骤2手动指定编译路径无pkg-config场景Linux/macOSbashexport CFLAGS-I/头文件目录/ft2build.hexport LDFLAGS-L/库文件目录/libfreetype.soWindows CMDcmdset CL/IC:\头文件路径\ft2build.hset LINK/LIBPATH:C:\库文件路径\freetype.lib修改配置后重新编译前清理缓存bashgit clean -xfd#### 离线源码编译无法联网自动下载依赖包时手动将FreeType/QHull源码压缩包放入仓库 subprojects/packagecache 文件夹构建系统会自动校验SHA256哈希并解压编译。### Linux 最低pip与manylinux版本兼容- Python 3.9manylinux2014 镜像要求 pip ≥ 19.3### 源码构建依赖编译阶段需要1. Python构建工具- meson-python ≥0.13.1- pybind11 ≥2.13.2C/C与Python绑定- setuptools_scm ≥7Git版本号自动生成- NumPy ≥1.222. 编译工具- ninja ≥1.8.2Meson构建加速3. C编译器要求必须支持C17标准| 编译器 | 最低版本 | 适用平台 | 备注 || ---- | ---- | ---- | ---- || GCC | 7.2 | Linux、macOS、Windows | || Clang(LLVM) | 5.0 | Linux、macOS | || MSVC | 16.0 | Windows | VS2019及以上 |平台环境部署- Linuxsudo apt install build-essential 一键安装GCC工具链- macOS安装完整Xcode开发工具- Windows安装Visual Studio Build Tools勾选「使用C的桌面开发」组件也可使用WSL/Cygwin/MinGW64### 测试套件依赖#### 强制测试依赖- pytest ≥7.0.0#### 可选测试拓展包nbformat、nbconvert、pandas、pikepdf、psutil、pytest-cov、pytest-timeout、pytest-xdist、pytest-xvfb、pytz、sphinx、xarray#### 外部测试工具Ghostscript ≥9.0、Inkscape、文泉驿正黑、Noto Sans CJK 中文字体 Windows安装Inkscape务必勾选**添加到系统PATH**否则PDF/SVG渲染测试失败。### 文档构建依赖1. Python包一键安装bashpip install --group doc2. 外部独立程序- Graphviz流程图渲染- LaTeX发行版TeXLive / MikTeX#### LaTeX必须安装组件集合| 集合分类 | 所需软件包 || ---- | ---- || 基础内核 | cm, luahbtex || 字体包 | cm-super, lm, txfonts || 标准LaTeX | fix-cm, geometry, hyperref, latex, latex-bin, psnfss || 拓展工具 | import, sfmath, type1cm || 推荐宏包 | fontspec, underscore || XeTeX引擎 | xetex, xetex-bin |额外必装dvipng使用PGF后端需额外安装 pgf#### 文档构建可选工具消除警告Inkscape、optipng、ffmpeg、xkcd字体、Times New Roman字体---# 1.7 常见问题 FAQ## 1.7.1 如何提交编译报错反馈整理系统版本、Python版本、完整编译日志、依赖版本清单提交至Matplotlib GitHub Issues。## 1.7.2 安装成功但图表窗口无法弹出1. 彻底卸载重装所有依赖2. 使用独立Python脚本运行不要在IDLE、交互式终端直接执行3. 执行调试命令查看后端加载日志bashpython -c from pylab import *; set_loglevel(DEBUG); plot(); show()根据日志定位后端加载问题修改 matplotlibrc 或 MPLBACKEND 环境变量。## 1.7.3 完整卸载Matplotlib干净环境1. 删除 MPLCONFIGDIR 指定目录下所有缓存与配置文件2. 删除Python site-packages下所有matplotlib相关文件夹与egg文件。## 1.7.4 macOS 系统专属注意事项### 不推荐使用系统自带PythonmacOS预装 /usr/bin/python 绑定的Matplotlib无法独立升级强烈推荐以下方案1. Anaconda 科学计算发行版最省心2. python.org 官方独立Python安装包3. Homebrew / MacPorts 包管理器安装Python。### MacPorts 先安装pipbashsudo port install py38-pippython3 -m pip install matplotlib### 校验安装是否生效bashpython3 -c import matplotlib; print(matplotlib.__version__, matplotlib.__file__)正常输出示例3.10.0 /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/matplotlib/__init__.py报错 ImportError 大概率是调用了系统自带Python执行 which python3 核查解释器路径。---# 1.8 故障排查实用命令## 1.8.1 查看Matplotlib版本pythonimport matplotlibprint(matplotlib.__version__)## 1.8.2 查看安装路径pythonimport matplotlibprint(matplotlib.__file__)## 1.8.3 查看配置目录 缓存目录pythonimport matplotlib as mpl# 用户配置文件夹matplotlibrc存放处print(mpl.get_configdir())# 字体缓存、运行缓存文件夹print(mpl.get_cachedir())- Linux/macOS配置与缓存目录分离- Windows配置与缓存共用同一个 .matplotlib 文件夹可通过 MPLCONFIGDIR 环境变量统一修改路径。--- Matplotlib官方文档40万字中文翻译 Part 1安装(持续更新)
Matplotlib 是一个功能全面的 Python 可视化库用于绘制静态、动画及交互式图表。---# 第一部分 安装## 主流包管理器一键安装### 1. pipbashpip install matplotlib### 2. condabashconda install -c conda-forge matplotlib### 3. pixibashpixi add matplotlib### 4. uvbashuv add matplotlib ⚠️ **警告** uv 会默认安装独立版本 Python源自 python-build-standalone 项目。截至2025年8月仅新版绑定的 Python 才能正常通过 tkagg 后端弹窗显示图表。 1. 将 uv 更新至 0.8.7 及以上版本 bash uv self update 2. 升级内置 Python 运行环境 bash uv python upgrade --reinstall 若仍无法使用 TkAgg 后端可直接安装 Qt 依赖使用其他GUI框架 bash uv add matplotlib pyside6 ### 其他安装方式1. 安装官方发布二进制版本2. 安装社区夜间构建版本3. 从源代码手动编译安装---## 1.1 安装官方发行版Matplotlib 已为 macOS、Windows、Linux 全平台在 PyPI 提供预编译 wheel 安装包推荐使用 pip 安装bash# 先升级pippython -m pip install -U pip# 安装/升级matplotlibpython -m pip install -U matplotlib### 编译安装报错解决方案如果执行上述命令触发源码编译并出现异常添加 --prefer-binary 参数强制使用系统对应预编译包bashpython -m pip install -U matplotlib --prefer-binary### 后端默认支持说明1. 无需额外依赖即可直接使用的非交互式后端Agg、ps、pdf、svg2. TkAgg 交互式后端依赖 Python 标准库 tkinter。部分系统需手动安装系统包如 Debian/Ubuntu 的 python3-tk3. uv 内置 Python 环境在2025年8月之后才完整支持 Tk 绑定异常请执行前文 uv 升级命令。如需启用其他GUI框架、LaTeX公式渲染、动画导出、拓展文件保存格式需手动安装**可选依赖包**。---## 1.2 第三方渠道分发安装### 1.2.1 Conda 渠道安装1. Anaconda 官方主渠道bashconda install matplotlib2. conda-forge 社区开源渠道推荐bashconda install -c conda-forge matplotlib### 1.2.2 内置Matplotlib的Python发行版以下完整版科学计算环境已预装Matplotlib无需手动安装- Anaconda- ActiveState ActivePython- WinPython### 1.2.3 Linux 系统包管理器安装使用操作系统自带Python时直接用系统包管理器安装- Debian / Ubuntubashsudo apt-get install python3-matplotlib- Fedorabashsudo dnf install python3-matplotlib- RedHat/CentOSbashsudo yum install python3-matplotlib- Arch Linuxbashsudo pacman -S python-matplotlib---## 1.3 安装夜间开发构建版本Matplotlib 每日开发版打包托管在 Anaconda Cloud通过 pip 指定私有索引安装bashpython -m pip install --upgrade --pre \--index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple \--extra-index-url https://pypi.org/simple matplotlib---## 1.4 从源代码编译安装### 适用场景1. 需要向 Matplotlib 开源仓库提交代码贡献2. 必须使用尚未正式发布的最新开发分支代码。 ⚠️ 注意普通生产环境**不推荐源码编译**极易出现编译失败、本地单元测试无法通过等问题请优先使用预编译wheel包。### 前置要求编译前必须提前安装全部编译依赖源码包可从PyPI官网下载 tar.gz 压缩包。Windows 下自行打包 wheel/sdist 时源码目录内所有DLL文件都会被一并打入安装包注意清理冗余文件。---## 1.5 编译参数与全局默认行为配置项目根目录下 meson.options 文件可自定义编译行为例如指定默认渲染后端、开关附属可选依赖库编译等主要面向打包分发人员使用。### 1.5.1 环境变量配置核心| 环境变量 | 作用说明 || ---- | ---- || HOME | 用户根目录Linux下 ~ 等价于 $HOME || MPLBACKEND | 指定Matplotlib默认渲染后端详见后端说明文档 || MPLCONFIGDIR | 自定义配置文件与缓存存放目录。未定义时brLinuxHOME/.config/matplotlib配置 HOME/.cache/matplotlib缓存brWindows/macOSHOME/.matplotlibbr无写入权限时自动使用系统临时目录 || MPL_IGNORE_SYSTEM_FONTS | 启用后仅读取库内置字体不再扫描系统字体减少子进程开销 || PATH | 系统可执行文件搜索路径 || PYTHONPATH | Python模块导入额外搜索路径 || QT_API | Qt系列后端指定绑定库PyQt6/PySide6等 |#### Linux / macOS 设置环境变量1. 查看当前变量值bashecho $PYTHONPATH# 查看当前Shell类型echo $SHELL2. 临时设置变量终端生效关闭失效bash# bash / ksh 语法export PYTHONPATH~/Python# csh / tcsh 语法setenv PYTHONPATH ~/Python3. 路径前置/追加bash# 路径前置优先搜索export PATH~/bin:${PATH}setenv PATH ~/bin:${PATH}# 路径末尾追加export PATH${PATH}:~/binsetenv PATH ${PATH}:~/bin4. 永久生效将上述 export / setenv 命令写入对应Shell配置文件- bash~/.bashrc- csh~/.cshrc#### Windows 设置环境变量1. 打开路径控制面板 → 系统 → 高级系统设置 → 环境变量2. 在**用户变量**或**系统变量**中新建/编辑对应变量即可。 补充绘图全局样式、默认参数也可通过 rcParams / matplotlibrc 配置文件修改。---## 1.6 完整依赖清单使用 pip / conda 安装时**强制依赖会自动安装**本节用于排查异常、手动源码编译参考。### 1.6.1 运行时依赖#### 强制核心依赖必须安装- Python ≥ 3.11- contourpy ≥ 1.0.1- cycler ≥ 0.10.0- python-dateutil ≥ 2.7- fontTools ≥ 4.28.2- kiwisolver ≥ 1.3.1- NumPy ≥ 1.25- packaging ≥ 20.0- Pillow ≥ 9.0- pyparsing ≥ 3 Conda 说明 上述依赖被封装在 matplotlib-base 包内其他第三方包请依赖 matplotlib-base 而非直接依赖 matplotlib Conda 官方 matplotlib 元包自带 pyside6 后端开箱可用GUI绘图窗口。#### 可选拓展依赖按需安装##### 1. GUI渲染后端依赖- Tk 库≥8.5排除8.6.0/8.6.1版本TkAgg后端- PyQt6 / PySide6 / PyQt5 / PySide2Qt系列后端- PyGObject pycairo ≥1.14.0GTK后端- pycairo ≥1.14.0 或 cairocffi ≥0.8Cairo矢量渲染后端- wxPython ≥4WxWidgets后端- Tornado ≥5WebAgg网页交互式后端- ipykernelJupyter Notebook nbagg后端- macOS 系统 ≥10.12macOS原生后端##### 2. 动画与导出工具- ffmpeg视频文件导出- ImageMagickGIF动图导出##### 3. 字体与公式渲染- LaTeX配套 cm-super、underscore GhostScript ≥9.0公式文本渲染- fontconfig ≥2.7Linux系统字体自动扫描##### 4. C底层依赖库Matplotlib 内置副本- AggC抗锯齿2D渲染引擎- ttconvTrueType字体解析工具外部系统依赖- FreeType ≥2.3字体光栅化渲染- QHull ≥8.0.2版本别名2020.2几何三角剖分计算库### 使用系统自带FreeType/QHull编译默认安装会自动下载编译内置版本如需强制调用系统已安装库使用以下命令bashpython -m pip install matplotlib \--config-settingssetup-args-Dsystem-freetypetrue \--config-settingssetup-args-Dsystem-qhulltrue#### 步骤1安装系统开发库头文件bash# Debian/Ubuntusudo apt install libfreetype6-dev pkg-config# Fedorasudo dnf install freetype-devel pkgconf# macOS Homebrewbrew install freetype pkg-config# Conda全平台conda install freetype pkg-config#### 步骤2手动指定编译路径无pkg-config场景Linux/macOSbashexport CFLAGS-I/头文件目录/ft2build.hexport LDFLAGS-L/库文件目录/libfreetype.soWindows CMDcmdset CL/IC:\头文件路径\ft2build.hset LINK/LIBPATH:C:\库文件路径\freetype.lib修改配置后重新编译前清理缓存bashgit clean -xfd#### 离线源码编译无法联网自动下载依赖包时手动将FreeType/QHull源码压缩包放入仓库 subprojects/packagecache 文件夹构建系统会自动校验SHA256哈希并解压编译。### Linux 最低pip与manylinux版本兼容- Python 3.9manylinux2014 镜像要求 pip ≥ 19.3### 源码构建依赖编译阶段需要1. Python构建工具- meson-python ≥0.13.1- pybind11 ≥2.13.2C/C与Python绑定- setuptools_scm ≥7Git版本号自动生成- NumPy ≥1.222. 编译工具- ninja ≥1.8.2Meson构建加速3. C编译器要求必须支持C17标准| 编译器 | 最低版本 | 适用平台 | 备注 || ---- | ---- | ---- | ---- || GCC | 7.2 | Linux、macOS、Windows | || Clang(LLVM) | 5.0 | Linux、macOS | || MSVC | 16.0 | Windows | VS2019及以上 |平台环境部署- Linuxsudo apt install build-essential 一键安装GCC工具链- macOS安装完整Xcode开发工具- Windows安装Visual Studio Build Tools勾选「使用C的桌面开发」组件也可使用WSL/Cygwin/MinGW64### 测试套件依赖#### 强制测试依赖- pytest ≥7.0.0#### 可选测试拓展包nbformat、nbconvert、pandas、pikepdf、psutil、pytest-cov、pytest-timeout、pytest-xdist、pytest-xvfb、pytz、sphinx、xarray#### 外部测试工具Ghostscript ≥9.0、Inkscape、文泉驿正黑、Noto Sans CJK 中文字体 Windows安装Inkscape务必勾选**添加到系统PATH**否则PDF/SVG渲染测试失败。### 文档构建依赖1. Python包一键安装bashpip install --group doc2. 外部独立程序- Graphviz流程图渲染- LaTeX发行版TeXLive / MikTeX#### LaTeX必须安装组件集合| 集合分类 | 所需软件包 || ---- | ---- || 基础内核 | cm, luahbtex || 字体包 | cm-super, lm, txfonts || 标准LaTeX | fix-cm, geometry, hyperref, latex, latex-bin, psnfss || 拓展工具 | import, sfmath, type1cm || 推荐宏包 | fontspec, underscore || XeTeX引擎 | xetex, xetex-bin |额外必装dvipng使用PGF后端需额外安装 pgf#### 文档构建可选工具消除警告Inkscape、optipng、ffmpeg、xkcd字体、Times New Roman字体---# 1.7 常见问题 FAQ## 1.7.1 如何提交编译报错反馈整理系统版本、Python版本、完整编译日志、依赖版本清单提交至Matplotlib GitHub Issues。## 1.7.2 安装成功但图表窗口无法弹出1. 彻底卸载重装所有依赖2. 使用独立Python脚本运行不要在IDLE、交互式终端直接执行3. 执行调试命令查看后端加载日志bashpython -c from pylab import *; set_loglevel(DEBUG); plot(); show()根据日志定位后端加载问题修改 matplotlibrc 或 MPLBACKEND 环境变量。## 1.7.3 完整卸载Matplotlib干净环境1. 删除 MPLCONFIGDIR 指定目录下所有缓存与配置文件2. 删除Python site-packages下所有matplotlib相关文件夹与egg文件。## 1.7.4 macOS 系统专属注意事项### 不推荐使用系统自带PythonmacOS预装 /usr/bin/python 绑定的Matplotlib无法独立升级强烈推荐以下方案1. Anaconda 科学计算发行版最省心2. python.org 官方独立Python安装包3. Homebrew / MacPorts 包管理器安装Python。### MacPorts 先安装pipbashsudo port install py38-pippython3 -m pip install matplotlib### 校验安装是否生效bashpython3 -c import matplotlib; print(matplotlib.__version__, matplotlib.__file__)正常输出示例3.10.0 /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/matplotlib/__init__.py报错 ImportError 大概率是调用了系统自带Python执行 which python3 核查解释器路径。---# 1.8 故障排查实用命令## 1.8.1 查看Matplotlib版本pythonimport matplotlibprint(matplotlib.__version__)## 1.8.2 查看安装路径pythonimport matplotlibprint(matplotlib.__file__)## 1.8.3 查看配置目录 缓存目录pythonimport matplotlib as mpl# 用户配置文件夹matplotlibrc存放处print(mpl.get_configdir())# 字体缓存、运行缓存文件夹print(mpl.get_cachedir())- Linux/macOS配置与缓存目录分离- Windows配置与缓存共用同一个 .matplotlib 文件夹可通过 MPLCONFIGDIR 环境变量统一修改路径。---