新建React Native项目iOS Pod安装失败：无法加载指定文件

问题重现 #

新建React Native项目后，在iOS目录执行pod install时出现错误：

[!] Invalid `Podfile` file: cannot load such file -- /Users/..../AwesomeProject/node_modules/react-native/scripts/react_native_pods.rb

已确认文件存在，尝试过清理npm/yarn缓存、重装CocoaPods等常规方法无效。

解决方案 #

1. 替换Podfile的动态路径解析为绝对路径 #

Podfile中原本通过Node命令动态解析路径的逻辑可能因Node版本或环境问题失效，直接改用文件系统绝对路径引用：
将Podfile开头的这段代码：

require Pod::Executable.execute_command('node', ['-p',
  'require.resolve(
    "react-native/scripts/react_native_pods.rb",
    {paths: [process.argv[1]]},
  )', __dir__]).strip

替换为：

require File.join(__dir__, '../node_modules/react-native/scripts/react_native_pods.rb')

保存后重新执行pod install。

2. 切换到Node LTS版本 #

你当前使用的Node 21.6.1是非LTS版本，可能与React Native存在兼容性问题，切换到官方推荐的LTS版本（如20.x）：

# 安装nvm（若未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装并切换到Node 20 LTS
nvm install 20
nvm use 20

之后重新执行npm install，再进入iOS目录执行pod install。

3. 彻底清理依赖与缓存 #

执行以下命令彻底清除可能的残留缓存：

# 清理npm缓存
npm cache clean --force
# 删除本地依赖包与锁文件
rm -rf node_modules package-lock.json yarn.lock
# 重新安装项目依赖
npm install
# 清理iOS端Pod缓存
cd ios
rm -rf Pods Podfile.lock
pod deintegrate
pod install

4. 确保CocoaPods与终端使用同一Node环境 #

检查CocoaPods调用的Node路径是否与终端一致：

# 查看CocoaPods使用的Node路径
pod env | grep NODE
# 查看当前终端的Node路径
which node

若路径不一致，将当前Node路径添加到shell配置文件（如~/.zshrc或~/.bashrc）：

# 替换为你的Node实际路径，例如
echo 'export PATH="$HOME/.nvm/versions/node/v20.10.0/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

重启终端后重新执行pod install。

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