启动MERN栈React前端时npm提示找不到index.html文件求助

• 问题核心特征：执行npm start启动React前端时，报错找不到index.html，搜索路径指向项目根目录下的public文件夹，但实际public文件夹位于frontend子目录内；同仓库其他成员运行无异常，仅Windows设备出现问题；重装Node、重拉依赖、手动移动文件均无法解决。

修复步骤 #

• 第一步：排查环境变量配置
  检查frontend目录下的.env、.env.development等配置文件，删除所有PUBLIC_URL、BUILD_PATH相关的配置，若没有对应文件可新增.env文件写入以下内容：

  PUBLIC_URL=./
  

• 第二步：修正package.json配置
  打开frontend/package.json，确认两点：
  1. 根级别没有homepage字段，或该字段值为"./"
  2. scripts.start的值为默认的"react-scripts start"，没有额外添加路径参数
• 第三步：规避OneDrive同步目录异常
  你当前的项目存放在OneDrive同步路径下，OneDrive的文件锁、虚拟路径映射机制经常会导致Node.js的路径识别异常，将整个项目文件夹移动到本地非同步的普通目录（例如C:\Dev\）后重新执行npm start测试
• 第四步：临时指定路径启动验证
  若上述操作均无效，Windows环境下可在frontend目录手动指定路径启动，执行命令：

  set PUBLIC_URL=./ && npm start
  

  也可以在项目根目录的package.json中添加代理启动脚本，避免路径识别问题：

  {
    "scripts": {
      "start:frontend": "cd frontend && react-scripts start"
    }
  }
  

  后续在项目根目录执行npm run start:frontend即可正常启动。

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