MacOS ARM下VS Code终端与系统终端架构不一致问题求助

原因分析 #

VS Code终端和系统原生终端的架构差异，核心原因是VS Code本身以x86_64架构运行（通过Rosetta 2转译）：

• 系统原生终端默认继承MacOS ARM的原生Arm64环境；
• 若你安装的是x86_64版本的VS Code，它会在Rosetta 2的转译环境下启动，其内置终端会继承这个x86_64父进程的架构上下文；
• 即使Python是支持双架构的通用二进制包，程序会优先适配父进程的运行架构，所以VS Code终端里的Python会以x86_64模式执行，导致依赖包按x86_64编译，引发架构不兼容问题。

解决步骤 #

1. 切换到Arm64版本的VS Code #

• 卸载当前x86_64版本的VS Code；
• 下载对应Apple Silicon的VS Code版本（官网会自动识别设备架构，若未自动识别，手动选择Apple Silicon选项）；
• 重新安装后，在VS Code终端执行arch命令，确认输出为arm64。

2. 修复Python依赖环境 #

• 在VS Code的Arm64终端中，重新安装所有依赖包，覆盖之前的x86_64版本：

  pip install --force-reinstall -r requirements.txt
  

  （若没有requirements.txt，逐个重新安装出现问题的依赖包）

3. 排查强制架构的配置（可选） #

若切换版本后终端仍为x86_64，检查是否存在强制架构的环境变量配置：

• 查看~/.zshrc、~/.bashrc等配置文件，是否有类似export ARCHFLAGS="-arch x86_64"的语句，删除后重启终端。

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