matplotlib 3.11.0 api changes 页面显示,`pyplot.subplot` 和 `pyplot.subplot_mosaic` 在接收已有 figure 编号或 figure 实例时会抛出 valueerror,官方说明这些工具应严格用于创建新图和新子图。

来源:Matplotlib 官方文档与 GitHub Releases
过去这类调用可能因内部调用 `figure` 而意外复用已有图形。新行为要求复用时显式清理,例如使用 `clear=True`,或在已有 Figure 上通过对象式 API 添加子图。
这项变更会影响脚本、教学示例和 notebook 中复用 figure 编号的代码,尤其是把同一编号反复传入 `subplots` 或 `subplot_mosaic` 的场景。

来源:Matplotlib 官方文档与 GitHub Releases
Matplotlib这次更新更适合按版本维护信息处理。相关团队应先核对官方页面中列出的版本号、日期、接口或修复范围,再决定是否更新专区说明、依赖要求、测试脚本和兼容提示。
官方把这项内容列为行为变化,而不是简单弃用提醒。维护者在升级 3.11 前应优先运行包含绘图初始化的测试,确认没有隐藏复用逻辑。
信源说明:本文只依据Matplotlib 官方文档与 GitHub Releases中的公开可核验内容撰写,未采用第三方转述、论坛猜测或未确认传闻;正式下载、版本状态、接口行为和未来发布计划均以官方页面最新说明为准。
从专区维护角度看,Matplotlib稿件应保留具体来源、版本号、发布时间和限制条件。这样后续入库或改稿时,编辑可以直接回查官方页面,不会把旧版本说明误写成当前事实。
如果官方页面没有披露完整 Bug 编号、灰度范围、二进制包策略或平台差异,正文只保留已公开信息,并把未披露内容写入限制段。这样能保持新闻时效,也不会替官方补充不存在的承诺。
配图采用对应官方页面截图,并统一处理为 700×385 像素。图片只用于证明来源和事实位置,不替代文字核验;后续如进入 PHP.cn 后台,仍应保持图片居中和来源短句居中。










