Python 3.10.6中无法从collections导入Mapping的报错解决咨询

问题原因 #

Python 3.3及以后版本中，Mapping、MutableMapping这类抽象基类已经从collections核心模块迁移到collections.abc子模块。你使用的Python 3.10.6自然无法从旧路径找到Mapping。

修复步骤 #

• 修改项目内的导入代码：遍历自己的项目代码，找到所有from collections import Mapping的语句，替换为from collections.abc import Mapping。
• 排查第三方依赖库：如果报错来自第三方库，说明该库版本可能不兼容Python 3.10。要么升级该库到支持3.10的版本，要么更换为兼容的替代库。
• 确认虚拟环境一致性：检查当前使用的pyenv环境是否正确，避免混用不同Python版本的依赖包（比如不要把Python 2.x或3.2及以下的依赖安装到3.10环境）。
• 临时兼容方案（不推荐长期使用）：如果暂时无法全面修改导入路径，可以在代码开头加入兼容逻辑：

  try:
      from collections.abc import Mapping
  except ImportError:
      from collections import Mapping
  

注意 #

你贴出的/Users/User/.pyenv/versions/3.10.6/lib/python3.10/collections/__init__.py是Python系统自带文件，这个文件本身没有问题——3.10版本的collections模块确实不再导出Mapping，不要修改这个系统文件。

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