React.js项目执行npm start启动本地服务器时出现报错如何解决

报错原文 #

'Equipment' is not recognized as an internal or external command,
operable program or batch file. internal/modules/cjs/loader.js:983
throw err; ^
Error: Cannot find module
'C:\Users\Home\Desktop\react-scripts\bin\react-scripts.js'
at Function.Module._resolveFilename (internal/modules/cjs/loader.js:980:15)
at Function.Module._load (internal/modules/cjs/loader.js:862:27)
at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:74:12)
at internal/main/run_main_module.js:18:47 { code: 'MODULE_NOT_FOUND', requireStack: [] }

报错截图 #

解决方案 #

1. 修复项目路径问题 #

• 该报错核心诱因大多是项目存放路径包含空格、中文、特殊符号，系统解析路径时会把空格作为命令分隔符，将空格前的Equipment识别为待执行命令，才会出现命令不识别的报错。
• 操作方式：将项目移动到无空格、无中文、无特殊符号的纯英文路径下，例如C:\projects\my-react-demo。

2. 重新安装项目依赖 #

• 先删除项目根目录下的node_modules文件夹、package-lock.json文件（如果用yarn则删除yarn.lock）
• 终端进入项目根目录，执行npm install重新安装全量依赖
• 若仍提示找不到react-scripts模块，可单独执行npm install react-scripts --save安装该依赖。

3. 校验package.json配置 #

• 打开项目根目录的package.json文件，确认scripts字段配置如下：

{
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  }
}

• 不要手动修改为绝对路径的react-scripts，默认调用本地node_modules下的依赖即可。

4. 清理全局冲突版本 #

• 不要全局安装react-scripts，若之前有全局安装过，执行npm uninstall -g react-scripts删除全局版本，避免版本冲突导致调用异常。

内容的提问来源于stack exchange，提问作者Syed Hussain Abbas