Coolbox与matplotlib依赖问题：无法导入BrokenBarHCollection

问题场景 #

昨日在Jupyter Notebook中使用Coolbox处理HiC数据完全正常，今日执行import coolbox或from coolbox.api import *时触发如下错误：

ImportError: cannot import name 'BrokenBarHCollection' from 'matplotlib.collections'

已尝试重装Coolbox、更换matplotlib版本，且今日未进行任何软件更新操作，但问题仍未解决。

可行解决方案 #

• 核对Python环境一致性：Jupyter可能默认切换了内核环境，导致依赖版本和昨日不符。在Notebook中执行!pip list，查看当前环境的matplotlib、Coolbox版本，确认是否与昨日使用的环境一致。若不一致，切换回对应内核即可。
• 锁定matplotlib兼容版本：BrokenBarHCollection在matplotlib 3.7及以上版本中被迁移至matplotlib.patches模块，而旧版Coolbox仍从collections导入。指定安装兼容的matplotlib版本：

  pip install matplotlib==3.6.3
  

  随后强制重装Coolbox以适配：

  pip install --force-reinstall coolbox
  

• 临时修改Coolbox源码（进阶）：若上述方法无效，可手动修改Coolbox的导入语句。先通过import coolbox; print(coolbox.__file__)找到Coolbox安装目录，搜索所有包含from matplotlib.collections import BrokenBarHCollection的文件，将其替换为from matplotlib.patches import BrokenBarHCollection。
• 确认Jupyter内核匹配：在Jupyter的「Kernel」菜单中检查当前使用的内核是否与安装依赖的Python环境一致，避免因内核切换导致依赖缺失。

内容的提问来源于stack exchange，提问作者Phronek