如何让Xcode使用正确Node版本？React Native构建失败求助

我之前也踩过类似的坑，Xcode构建时完全无视nvm的配置，硬要去读系统原生的Node版本。先给你理清楚问题根源，再一步步解决：

问题本质 #

nvm里的system别名只是nvm内部的一个标记，它指向的是系统路径里的原生Node，不是nvm管理的版本。你执行nvm alias system 8.7.0只是让nvm内部把"system"对应到8.7.0，但Xcode调用的是系统级的node命令（比如/usr/local/bin/node或者/usr/bin/node），这个路径下的Node还是你之前装的v4.4.3，所以完全没效果。

具体解决步骤 #

1. 清理brew的残留Node

你之前用brew装过Node，现在brew命令报错，先把brew相关的Node残留清掉：

# 强制卸载brew里的Node（如果存在）
brew uninstall node --force
# 清理brew缓存和冗余文件
brew cleanup
# 修复brew状态，按提示解决检测到的问题
brew doctor

2. 让Xcode加载nvm的Node版本

Xcode启动时不会读取shell的配置文件（比如.bash_profile/.zshrc），所以得手动让它加载nvm：

• 首先确保你的shell配置里已经包含nvm的加载脚本：
  打开终端运行：

  # 如果用bash
  echo 'source "$HOME/.nvm/nvm.sh"' >> ~/.bash_profile
  # 如果用zsh
  echo 'source "$HOME/.nvm/nvm.sh"' >> ~/.zshrc
  

• 然后在Xcode里添加前置Run Script构建阶段：
  1. 打开你的React Native项目的Xcode工程
  2. 选中主target，切换到Build Phases标签
  3. 点击+号，选择New Run Script Phase
  4. 在脚本框里输入：

     source "$HOME/.nvm/nvm.sh"
     nvm use 8.7.0
     

     把这个Run Script拖到Dependencies之后、Compile Sources之前，确保构建前先切换到指定Node版本。

3. （可选）替换系统Node为nvm版本（直接有效但不推荐）

如果你不想折腾Xcode配置，可以直接把系统路径的Node替换成nvm管理的版本：

# 先备份原来的系统Node
sudo mv /usr/local/bin/node /usr/local/bin/node_old
# 创建软链接到nvm的8.7.0版本
sudo ln -s "$(nvm which 8.7.0)" /usr/local/bin/node
# 验证是否生效
node -v

这样不管是终端还是Xcode，调用node都会用nvm的8.7.0版本了。

验证修复 #

重启Xcode后重新执行构建，应该就不会再出现使用v4.4.3的问题了。如果还是有问题，可以在Run Script里加一行which node，查看构建日志里的Node路径是否正确。

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