Python3.10安装numpy遇MutableMapping属性错误，如何替换collections为collections.abc？

一、快速修复numpy安装错误 #

这个错误的核心是Python3.10将collections.MutableMapping迁移到了collections.abc，而你系统中旧版本的setuptools/pkg_resources未适配该变更。以下是无需手动修改系统文件的简便方案：

1. 优先更新pip和setuptools #

执行以下命令强制更新包管理工具，修复依赖导入问题：

pip install --upgrade pip setuptools
pip install numpy

更新后，setuptools会自动适配Python3.10的模块结构，无需手动修改系统文件。

2. 使用虚拟环境隔离依赖（推荐） #

系统Python与手动升级的Python版本混合容易引发兼容性冲突，用虚拟环境彻底隔离：

# 创建Python3.10的虚拟环境
python3.10 -m venv ~/face_rec_env
# 激活虚拟环境
source ~/face_rec_env/bin/activate
# 激活后更新pip和setuptools
pip install --upgrade pip setuptools
# 安装numpy及目标人脸识别软件
pip install numpy

虚拟环境完全独立于系统环境，不会干扰系统自带的Python包。

二、Linux版本升级后的兼容性问题建议 #

1. 优先使用官方PPA安装高版本Python
   对于Ubuntu18.04，通过deadsnakes源安装Python3.10，而非手动编译：

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.10 python3.10-venv python3.10-dev

该源提供的Python包已适配Ubuntu18.04的系统环境，减少兼容性问题。

2. 用虚拟环境管理多版本依赖
   不同项目使用独立的虚拟环境，避免单个Python版本的依赖冲突影响全局。

3. 核对软件的Python版本要求
   升级Python前先确认目标人脸识别软件的官方Python版本支持范围，若软件兼容Python3.8（Ubuntu18.04可通过deadsnakes源安装），可选择兼容性更好的版本，减少升级成本。

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