VSCode React开发环境npm start与F5调试失效提示找不到index.html求助

安全阿岳

2026-9-26

日志中标注路径的说明

你提到的C:\React-Springboot-CRUD-App\node_modules\.bin路径属于npm执行脚本时的默认自动配置，不需要手动修改，也不是导致本次报错的原因：npm在运行npm start这类生命周期脚本时，会自动将当前项目的node_modules\.bin目录追加到环境变量PATH的最前列，目的是让项目本地安装的依赖命令（比如react-scripts）可以直接被调用，属于正常机制。

问题修复方案

报错的核心原因是react-scripts检索不到指定路径下的index.html，可按以下优先级排查修复：

确认public文件夹命名：react-scripts默认只会检索项目根目录下全小写命名的public文件夹，如果你实际的文件夹是大写PUBLIC或其他大小写混合形式，直接重命名为全小写public即可解决绝大多数此类问题。
确认index.html文件名：检查文件是否为全小写的index.html，排除Index.html、index.HTML这类大小写不符的命名，Windows文件系统本身大小写不敏感，但react-scripts的文件检索逻辑为大小写敏感。
确认终端执行路径：执行npm start时，确认终端当前工作目录就是项目根目录C:\React-Springboot-CRUD-App，不要在子目录下执行启动命令。
清理缓存重装依赖：如果上述配置都正确，依次执行以下命令重置依赖：
```
npm cache clean --force
rmdir /s /q node_modules
del package-lock.json
npm install
```
检查文件权限：右键点击public文件夹→选择「属性」→切换到「安全」标签页，确认当前Windows用户对该文件夹和内部的index.html拥有读取权限，没有被系统、安全软件限制访问。
检查自定义配置：如果之前修改过react-scripts的检索规则（比如使用customize-cra、新增了config-overrides.js配置、手动修改过node_modules里的paths配置），确认没有改动public目录的默认检索路径。