Mac系统VSCode中导入Numpy出现ImportError问题求助

核心问题 #

报错明确显示：Numpy的C扩展文件为x86_64架构，但你的Mac需要arm64e/arm64架构，属于架构不兼容，大概率是使用了Rosetta转译的Python环境安装Numpy，或直接安装了x86版本的包。

具体修复步骤 #

1. 确认当前Python环境的架构 #

在VSCode终端执行：

python3 -c "import platform; print(platform.machine())"

• 输出x86_64：说明使用的是Rosetta转译的Python
• 输出arm64：说明是原生ARM环境

2. 卸载现有Numpy #

先移除错误版本的Numpy：

pip3 uninstall -y numpy

3. 安装对应架构的Numpy #

情况一：Python为ARM架构（输出arm64）

直接用pip重新安装：

pip3 install numpy==2.1.3

若仍有问题，尝试从源码编译（需先安装Xcode命令行工具）：

pip3 install --no-binary :all: numpy==2.1.3

情况二：Python为x86_64架构（输出x86_64）

推荐切换到原生ARM Python，或强制用Rosetta安装：

• 切换原生ARM Python：Mac自带ARM Python路径为/usr/bin/python3，Homebrew安装的为/opt/homebrew/bin/python3，在VSCode左下角状态栏切换到该解释器后，重新安装Numpy。
• 强制Rosetta安装：右键终端选择「使用Rosetta打开」，再执行pip3 install numpy==2.1.3。

4. 验证修复 #

在VSCode的Python交互环境中执行：

import numpy
print(numpy.__version__)
print(numpy.__file__)

能正常输出版本和路径则说明问题解决。

额外注意 #

• 不要在Numpy源码目录下运行Python，确保工作目录不在Numpy源码文件夹内。
• VSCode需选择正确的Python解释器，左下角状态栏可切换，保证与终端使用的环境一致。

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