Xcode构建阶段无法找到Node：命令未找到问题求助

核心原因 #

Xcode执行构建脚本时的环境变量和终端环境不一致，nvm配置的Node路径未被纳入Xcode的PATH中，导致无法找到node命令。

具体解决思路 #

• 直接使用Node绝对路径（最直接方案）
  在终端运行which node，获取Node的完整路径（例如/Users/your-name/.nvm/versions/node/v18.17.0/bin/node），将构建脚本里的node -v替换为该绝对路径，示例：

  /Users/your-name/.nvm/versions/node/v18.17.0/bin/node -v
  

• 在构建脚本中加载nvm配置
  Xcode默认不会加载终端的shell配置文件，可在脚本开头手动加载：

  • 若使用zsh，添加：

    source ~/.zshrc
    

  • 若使用bash，添加：

    source ~/.bash_profile
    

  加载完成后再执行node -v即可。

• 为Xcode配置全局PATH环境变量

  1. 打开Xcode项目，选中目标Target，进入Build Settings标签页
  2. 搜索Environment Variables，点击+新增变量
  3. 变量名设为PATH，变量值填写$PATH:/你的node绝对路径所在的bin目录，示例：

     $PATH:/Users/your-name/.nvm/versions/node/v18.17.0/bin
     

• 排查与同事的环境差异

  • 确认是否设置了nvm默认版本：终端运行nvm alias default，若未设置，执行nvm alias default vx.x.x（替换为你常用的Node版本）
  • 检查Xcode命令行工具版本：Xcode -> Settings -> Locations -> Command Line Tools，确保与同事一致
  • 确认Xcode使用的shell：终端运行echo $SHELL，查看是否与同事使用的shell（zsh或bash）一致

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