使用TypeScript创建React应用遇模块找不到错误，求助解决方法

云上老周

2026-7-9

解决TypeScript React项目中"Cannot find module 'react'"报错的方案

检查依赖安装完整性
- 如果项目中没有node_modules文件夹，直接执行npm install安装所有依赖；若已存在，删除node_modules和package-lock.json（或yarn.lock）文件后重新执行npm install，避免依赖缓存或安装不完整问题。
- 确认package.json的dependencies中包含react，devDependencies中包含@types/react，若缺失，执行以下命令补装：
```
npm install react react-dom
npm install --save-dev @types/react @types/react-dom typescript
```

验证tsconfig.json配置
确保compilerOptions里的关键配置正确，示例如下：

{
  "compilerOptions": {
    "jsx": "react-jsx", // React 17及以上版本推荐使用该值，旧版本可设为"react"
    "moduleResolution": "node",
    "esModuleInterop": true,
    "skipLibCheck": true,
    "target": "ESNext"
  },
  "include": ["src/**/*"] // 确保TS能扫描到源码目录
}

重启TypeScript语言服务或编辑器
- 在VS Code中，按下Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），搜索并执行"TypeScript: Restart TS Server"，清除语言服务缓存。
- 若上述操作无效，直接重启编辑器，刷新项目状态。
统一包管理器
不要混用npm、yarn或pnpm等包管理器，确保所有依赖安装命令都使用同一个工具，避免依赖树冲突。