macOS React Native .xcode.env.local Node路径无法正确配置

问题原因 #

• Yarn（尤其是Yarn Berry版本）默认启用Plug'n'Play (PnP) 机制，会在临时目录生成隔离的Node二进制文件，替代系统/版本管理器管理的Node。
• Yarn脚本、Xcode脚本阶段默认使用非交互式Shell，这类Shell不会自动加载asdf-vm的环境配置，导致无法识别asdf管理的Node路径。

解决方案 #

1. 禁用Yarn PnP（推荐，适用于Yarn Berry） #

在项目根目录创建或修改.yarnrc.yml，添加配置强制使用系统Node：

nodeLinker: node-modules

执行yarn install使配置生效，之后Yarn脚本会自动使用asdf管理的Node路径。

2. 显式加载asdf环境（解决Xcode脚本问题） #

修改项目中的.xcode.env文件，在导出NODE_BINARY前加载asdf的配置：

# This `.xcode.env` file is versioned and is used to source the environment
# used when running script phases inside Xcode.
# To customize your local environment, you can create an `.xcode.env.local`
# file that is not versioned.

# NODE_BINARY variable contains the PATH to the node executable.
#
# Customize the NODE_BINARY variable here.
# For example, to use nvm with brew, add the following line
# . "$(brew --prefix nvm)/nvm.sh" --no-use

# 加载asdf环境配置
. "$HOME/.asdf/asdf.sh"
export NODE_BINARY=$(command -v node)

修改后，Xcode执行脚本阶段时会正确加载asdf的Node路径，生成的.xcode.env.local也会写入正确路径。

3. 确保asdf在非交互式Shell中生效 #

检查你的Shell配置文件（~/.zshrc、~/.bashrc或~/.profile），确保asdf的初始化代码存在：

. "$HOME/.asdf/asdf.sh"

注意不要仅将asdf配置放在~/.bash_profile（仅交互式登录Shell加载），确保非交互式Shell也能识别asdf管理的Node。

4. 临时修复：Yarn脚本中显式加载asdf #

如果仅需临时让Yarn脚本返回正确路径，修改package.json的脚本：

"scripts": {
    "nodePath": ". $HOME/.asdf/asdf.sh && which node",
    "nodepath": ". $HOME/.asdf/asdf.sh && command -v node"
}

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