如何将M2 Mac上的Python x86包替换为arm64版本？

问题根源 #

迁移过来的Python环境为x86架构，且pip可能仍关联x86版本，导致重装包时依然安装x86架构版本，与ARM的M2芯片不兼容。

解决步骤 #

1. 确认当前Python架构 #

运行以下命令检查Python的架构：

file $(which python3)

如果输出包含x86_64，说明当前使用的是Rosetta兼容的x86版本，需切换到ARM原生版本。

2. 清理所有x86架构的Python包 #

• 导出已安装包的列表：

  pip freeze > requirements.txt
  

• 批量卸载所有包：

  pip uninstall -y -r requirements.txt
  

• 删除残留的包文件（对应你的Python版本3.10）：

  rm -rf ~/Library/Python/3.10/lib/python/site-packages
  rm -rf /Library/Frameworks/Python.framework/Versions/3.10
  

3. 安装ARM原生Python环境 #

方式一：使用Homebrew（推荐）

确保Homebrew为ARM版本（路径为/opt/homebrew，而非/usr/local），若之前是x86版Homebrew，需重新安装ARM版。之后执行：

brew install python

安装完成后，验证架构：

file $(which python3)

输出应包含arm64。

方式二：使用pyenv管理版本

• 安装pyenv：

  brew install pyenv
  

• 安装ARM版Python 3.10（替换为你需要的具体版本）：

  pyenv install 3.10.12
  

• 设置全局使用该版本：

  pyenv global 3.10.12
  

• 重启终端后验证：

  python3 --version
  file $(which python3)
  

4. 重新安装所有Python包 #

使用ARM版pip安装依赖：

pip install -r requirements.txt

5. 配置开发环境（以VS Code为例） #

在VS Code中打开命令面板（Cmd+Shift+P），选择Python: Select Interpreter，选择刚安装的ARM版Python路径（如/opt/homebrew/bin/python3或~/.pyenv/shims/python3）。

内容的提问来源于stack exchange，提问作者Benoît Boidin