执行npx react-native init AwesomeProject报错node模块加载异常求助

这个报错是Node.js无法正确加载模块导致的，试试以下步骤修复：

1. 确认Node.js版本符合要求 #

React Native仅支持特定Node.js LTS版本（当前推荐18.x/20.x），先检查版本：

node -v

如果版本不符，用nvm切换到兼容版本：

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

2. 彻底清理缓存与残留包 #

缓存损坏或残留的全局包会引发加载问题：

# 清理npm缓存
npm cache clean --force
# 卸载所有全局React Native相关工具
npm uninstall -g @react-native-community/cli react-native-cli create-react-app
# 若已有本地项目，删除依赖文件
rm -rf node_modules package-lock.json yarn.lock

3. 按官方流程重新创建项目 #

不要用npm init，直接用npx调用官方cli创建项目（无需全局安装）：

npx react-native init YourAppName

4. 检查环境变量与权限 #

• 路径检查：确保Node.js的bin目录在系统PATH中，执行echo $PATH（Linux/macOS）或echo %PATH%（Windows）验证。
• 权限修复（Linux/macOS）：若全局包目录权限异常，执行：

  sudo chown -R $USER:$GROUP ~/.npm
  

进阶排查 #

如果以上步骤无效，检查npm config get prefix返回的全局包路径是否正常，若路径错误，重置为默认：

# Linux/macOS默认路径
npm config set prefix /usr/local
# Windows默认路径
npm config set prefix C:\Users\<你的用户名>\AppData\Roaming\npm

内容的提问来源于stack exchange，提问作者Kulaba Brian Austin