创建React项目时遇模块缺失等错误，寻求解决办法

问题概述 #

执行命令C:\Users\tusha\Desktop\New folder (4)>npx create-react-app my-app时出现两类错误：

1. 提示'CALL "C:\Program Files\nodejs\node.exe" "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js" prefix -g'不是内部或外部命令、可运行程序/批处理文件
2. 报错Error: Cannot find module 'C:\Program Files\nodejs\node_modules\npm\bin\npx-cli.js'，调用栈如下：

at Module._resolveFilename (node:internal/modules/cjs/loader:1075:15)
at Module._load (node:internal/modules/cjs/loader:920:27)
at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
at node:internal/main/run_main_module:23:47 {
code: 'MODULE_NOT_FOUND',
requireStack: []
}

当前使用Node.js v18.15.0，已尝试重装Node.js及重新创建模块文件，问题仍未解决。

有效解决方案 #

1. 检查并修复环境变量 #

• 打开系统环境变量设置（右键此电脑→属性→高级系统设置→环境变量），在系统变量的PATH中添加或确认以下两个路径存在，且优先级高于其他可能冲突的路径：
  • C:\Program Files\nodejs\
  • C:\Program Files\nodejs\node_modules\npm\bin\
• 验证：重启终端后执行node -v、npm -v、npx -v，若均能返回对应版本号，说明路径配置正常。

2. 手动修复npx-cli.js文件 #

• 确认C:\Program Files\nodejs\node_modules\npm\bin\目录下是否存在npx-cli.js，若缺失，可从对应npm版本的源码包中提取该文件放入目录。
• 或者强制重新安装npm：

  npm uninstall -g npm
  node -e "const fs = require('fs'); fs.rmSync('C:\\Program Files\\nodejs\\node_modules\\npm', { recursive: true, force: true });"
  npm install -g npm@latest
  

3. 绕过npx直接创建项目 #

• 清理npm缓存：

  npm cache clean --force
  

• 全局安装create-react-app后创建项目：

  npm install -g create-react-app
  create-react-app my-app
  

4. 彻底重装Node.js（无残留） #

• 卸载Node.js后，手动删除以下目录：
  • C:\Program Files\nodejs\
  • C:\Users\[你的用户名]\AppData\Roaming\npm
  • C:\Users\[你的用户名]\AppData\Roaming\npm-cache
• 下载Node.js v18.15.0安装包，选择自定义安装，确保勾选"npm package manager"，且安装路径不要包含中文或空格（推荐路径如C:\nodejs\）。

5. 更换终端执行命令 #

• 关闭当前CMD窗口，以管理员身份打开PowerShell，直接执行npx create-react-app my-app，避免CMD环境变量加载异常。

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