React官方教程运行npm start报错找不到src/index.js如何解决
问题诱因
react-scripts(Create React App 脚手架的核心执行依赖)有硬编码的入口文件查找规则:默认会从项目根目录下的src文件夹中寻找index.js作为项目启动入口,出现该报错的核心原因就是对应路径下不存在符合要求的入口文件,常见触发场景包括:
- 初始化项目后误删除、重命名了
src目录下的index.js文件 - 手动修改了入口文件的名称(比如改为
index.jsx、main.js等),没有同步修改构建配置 src目录被误移动、重命名,导致依赖的查找路径失效
修复步骤
- 在VS Code中打开项目根目录(即报错信息里的
C:\Users\myname\my-app路径),展开左侧资源管理器的src文件夹核对文件结构:- 若
index.js被误删/重命名:直接在src目录下新建名为index.js的文件,填入React项目的标准入口代码:import React from 'react'; import ReactDOM from 'react-dom/client'; import App from './App'; const root = ReactDOM.createRoot(document.getElementById('root')); root.render( <React.StrictMode> <App /> </React.StrictMode> ); - 若你之前自定义了入口文件名:学习官方教程阶段不建议修改默认配置,直接把自定义命名的入口文件改回
index.js即可,避免额外配置产生的兼容问题 - 若
src文件夹被移动到了其他位置:将src文件夹移回项目根目录,确保可以直接通过项目根目录/src/index.js路径访问到入口文件
- 若
- 文件结构核对修复完成后,在终端重新执行
npm start命令即可正常启动项目。
内容的提问来源于stack exchange,提问作者Jerry Huo
相关产品推荐
相关产品推荐

