VS Code集成终端安装Realm包失败，但macOS终端可正常运行

原因分析 #

核心问题是VS Code集成终端的运行环境与系统终端存在差异，导致Realm安装时尝试下载不存在的预编译二进制包：

1. VS Code集成终端运行在arm64架构下，使用的Node.js 16.10.0版本，但Realm 10.1.2未为该版本的arm64架构提供预编译二进制包（从404报错可确认），回退源码编译时因依赖缺失或环境问题失败。
2. 系统终端默认使用了x64架构的Node.js（通过Rosetta兼容层运行），而Realm 10.1.2有对应x64的预编译包，因此安装正常。

解决方案 #

方案1：切换VS Code终端到x64架构运行 #

• 关闭VS Code，右键点击VS Code图标，选择**"使用Rosetta打开"**。
• 打开项目后，在集成终端执行命令切换到x64 shell：

  arch -x86_64 zsh  # 若使用bash，替换为arch -x86_64 bash
  

• 重新执行yarn install。

方案2：升级Realm到兼容版本 #

Realm 10.7.0及以上版本已添加对Node.js 16 arm64架构的预编译支持，直接升级依赖：

• 修改项目package.json，将realm版本更新为^10.7.0（或更高兼容版本）。
• 执行yarn install。

方案3：手动编译Realm源码 #

若需保留当前Realm版本，先安装编译依赖再手动编译：

1. 安装Xcode命令行工具：

   xcode-select --install
   

2. 在VS Code集成终端执行：

   yarn install --ignore-scripts=false
   

   该命令会强制node-gyp从源码编译Realm，适配当前环境。

方案4：检查并修正终端环境变量 #

若VS Code终端设置了强制arm64的环境变量，取消后重试：

• 在VS Code终端执行：

  unset npm_config_arch
  

• 再执行yarn install。
• 若每次打开终端都出现该问题，可修改VS Code配置：打开settings.json，删除terminal.integrated.env.osx中的npm_config_arch相关配置。

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