React+TypeScript+Yarn环境下Recharts导入失败（TS2307错误）

AI 小北

2026-8-8

解决TS2307: Cannot find module 'recharts' or its corresponding type declarations

排查与修复步骤

确认依赖安装完整性
先检查项目根目录的package.json，确保recharts出现在dependencies中，@types/recharts在devDependencies内；同时查看node_modules文件夹，确认存在recharts和@types/recharts两个子目录。若缺失，重新执行安装命令：
```
yarn add recharts
yarn add -D @types/recharts
```
重启TS服务与开发服务器
若使用VS Code开发，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），选择「TypeScript: Restart TS Server」；同时重启webpack开发服务，清除编译缓存后重新尝试。
匹配主包与类型包版本
@types/recharts需要和recharts主包版本兼容，版本不匹配会导致类型识别失败。尝试安装最新兼容版本：
```
yarn add recharts@latest @types/recharts@latest
```
检查tsconfig.json配置
确保tsconfig.json的compilerOptions包含以下基础配置（默认已存在，若手动修改过需验证）：
```
{
  "compilerOptions": {
    "moduleResolution": "node",
    "typeRoots": ["./node_modules/@types"]
  }
}
```
彻底重装依赖
若以上步骤无效，删除node_modules文件夹和yarn.lock文件，重新安装所有依赖：
```
rm -rf node_modules yarn.lock
yarn install
```