执行npx create-react-native-app时模块缺失问题求助

问题分析 #

报错显示npm核心依赖模块（@npmcli/config、semver）缺失，原因通常是系统自带npm与手动安装的Node.js版本不兼容，或npm安装文件损坏、环境路径冲突。

解决步骤 #

1. 检查Node.js与npm的路径冲突 #

执行以下命令查看当前node和npm的执行路径：

which node
which npm

如果npm路径指向系统目录（比如/usr/share/nodejs/npm），而node路径是你手动安装的目录（比如/usr/local/bin/node），说明两者来源不一致，存在冲突。

2. 修复或重装npm #

如果直接执行npm install -g npm@latest报错，用Node.js自带的脚本重装npm：

node -e "const {execSync} = require('child_process'); execSync('curl -qL https://www.npmjs.com/install.sh | sh', {stdio: 'inherit'})"

3. 清理npm缓存 #

清除损坏的缓存文件：

npm cache clean --force

4. 调整环境变量PATH #

确保手动安装的Node.js目录优先级高于系统目录：

• 编辑终端配置文件（如~/.bashrc、~/.zshrc），添加以下内容（替换为你的Node.js实际安装路径）：

export PATH="/usr/local/bin:$PATH"

• 执行source ~/.bashrc（或对应配置文件）使变更生效。

5. 用nvm管理Node.js版本（彻底解决路径冲突） #

如果上述方法无效，建议用nvm统一管理Node.js版本，避免与系统自带版本冲突：

• 卸载现有Node.js和npm：
  • Ubuntu/Debian：sudo apt remove --purge nodejs npm
  • macOS（brew安装）：brew uninstall node
• 安装nvm后，执行以下命令安装并设置默认版本：

nvm install 20.3.0
nvm alias default 20.3.0

6. 验证修复结果 #

执行以下命令确认版本正常：

node -v
npm -v

之后尝试重新执行npx create-react-native-app。

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