执行npm start启动React路由v6项目时遇路径及模块找不到错误求助

问题场景 #

在PowerShell中执行命令：

PS D:\React培训项目\React路由项目版本5 & 6\React路由项目v6> npm start

触发的启动脚本：

react-router-6-upgrade@0.1.0 start
react-scripts start

出现错误：

系统找不到指定的路径。
node:internal/modules/cjs/loader:959
throw err;
^

错误：找不到模块 'D:\React training projects\react-scripts\bin\react-scripts.js'
    在 Function.Module._resolveFilename (node:internal/modules/cjs/loader:956:15)
    在 Function.Module._load (node:internal/modules/cjs/loader:804:27)
    在 Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
    在 node:internal/main/run_main_module:17:47 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

原因分析 #

从错误路径可见，Node.js将项目的中文路径D:\React培训项目\...自动转译为英文路径D:\React training projects\...，导致无法匹配实际存在的依赖模块，本质是中文路径引发的模块解析异常。

解决方案 #

方案一：迁移项目到纯英文路径 #

1. 将项目文件夹移动到不含中文、空格或特殊字符的路径，例如D:\ReactProjects\ReactRouterV6
2. 打开PowerShell切换到新路径：

   cd D:\ReactProjects\ReactRouterV6
   

3. 重新安装依赖：

   npm install
   

4. 执行启动命令：

   npm start
   

方案二：修复现有中文路径下的依赖 #

1. 删除项目根目录的node_modules文件夹和package-lock.json文件
2. 重新安装依赖（强制忽略可选依赖）：

   npm install --no-optional
   

3. 执行启动命令：

   npm start
   

方案三：手动安装react-scripts #

如果上述方法无效，直接安装react-scripts依赖：

npm install react-scripts --save-dev

安装完成后重新执行npm start

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