Conda环境安装numpy 1.16遇distutils.msvccompiler缺失错误

核心问题分析 #

你遇到的错误主要来自两个方面：

• ModuleNotFoundError: No module named 'distutils.msvccompiler'：缺少编译numpy所需的系统工具或Python distutils组件
• numpy 1.16是老旧版本，与新版Python（3.8+）不兼容，且pip安装需要本地编译，容易触发依赖问题

解决步骤 #

1. 优先使用conda安装（最稳妥）

conda会自动处理依赖和兼容问题，避免手动编译的麻烦：

# 直接安装numpy 1.16
conda install numpy=1.16

# 如果官方频道找不到包，添加conda-forge频道
conda install -c conda-forge numpy=1.16

2. 若必须使用pip，先修复编译依赖

根据你的操作系统安装对应的工具：

• Windows：安装Visual Studio Build Tools，勾选「Desktop development with C++」组件（建议选择VS2017版本，适配numpy 1.16的编译需求）
• Linux（Ubuntu/Debian）：安装Python distutils包

  sudo apt-get update && sudo apt-get install python3-distutils
  

• Linux（CentOS/RHEL）：

  sudo yum install python3-distutils
  

• macOS：安装Xcode命令行工具

  xcode-select --install
  

修复后清理pip缓存再尝试安装：

pip cache purge
pip install numpy==1.16

3. 创建兼容的全新conda环境（彻底解决版本冲突）

numpy 1.16仅支持Python 3.5-3.7版本，如果你当前环境的Python版本过高（3.8+），直接安装必然失败。创建指定Python版本的环境：

# 创建Python 3.7的环境，命名为numpy116
conda create -n numpy116 python=3.7
# 激活环境
conda activate numpy116
# 安装numpy 1.16
conda install numpy=1.16

额外提示 #

• 避免在conda环境中混用pip和conda安装核心依赖（如numpy），容易导致依赖冲突和版本不兼容
• numpy 1.16是停止维护的老旧版本，若不是必须，建议使用兼容当前Python版本的numpy稳定版（如1.21.x，适配Python 3.7-3.10）

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