MacBook M3运行Python脚本遇NumPy架构不兼容错误求助

核心原因 #

终端默认调用的Python是x86_64架构版本，而M3芯片需要arm64/arm64e架构的NumPy扩展，两者不匹配导致报错；Jupyter Notebook无问题是因为其使用的内核是适配arm64的Python版本，和终端默认路径不一致。

方法1：将默认Python切换为arm64版本 #

brew安装的arm64 Python默认路径是/opt/homebrew/bin/python3，通过设置shell别名让python/python3默认指向该版本：

1. 编辑shell配置文件（zsh用户用~/.zshrc，bash用户用~/.bash_profile）：

   echo "alias python='/opt/homebrew/bin/python3'" >> ~/.zshrc
   echo "alias python3='/opt/homebrew/bin/python3'" >> ~/.zshrc
   

2. 刷新配置使生效：

   source ~/.zshrc
   

3. 验证架构：

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

   输出应为arm64。

方法2：重建arm64架构的conda环境 #

如果依赖conda环境，需确保conda本身是arm64版本：

1. 检查当前conda架构：

   conda info | grep arch
   

   若显示x86_64，卸载现有conda后，从官方下载arm64版本的Miniconda/Anaconda重新安装。
2. 创建新的arm64环境并安装依赖：

   conda create -n arm_env python=3.11
   conda activate arm_env
   pip install numpy pandas
   

3. 验证环境内Python架构：

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

方法3：设置全局默认运行架构 #

通过环境变量让终端默认以arm64架构运行程序：

1. 在shell配置文件中添加：

   export ARCHFLAGS="-arch arm64"
   

2. 刷新配置后，直接运行Python脚本即可，无需手动加arch -arm64前缀。

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