已安装file-saver但React项目提示无法找到该依赖问题咨询

API 探路者

2026-9-29

解决方案

第一步：清除缓存全量重装依赖
先停止正在运行的本地开发服务，依次执行以下命令清理旧依赖和缓存：
```
rm -rf node_modules yarn.lock
yarn cache clean
```
执行完成后重新运行yarn install完成依赖安装，再启动开发服务验证问题是否解决。
第二步：调整导入语法与TS配置
file-saver v2.0.5版本的导出规则对混编ESM/CommonJS的打包工具兼容性不足，尝试将导入语句替换为默认导入格式：
```
import saveAs from 'file-saver'
```
如果你使用TypeScript，检查tsconfig.json中的moduleResolution配置项，确认值为node或bundler，不要使用classic配置，否则会导致类型依赖路径解析失败。
第三步：排查打包工具配置冲突
检查项目webpack/vite等打包工具的配置文件：
- 确认resolve.alias字段没有错误配置file-saver的别名路径
- 确认externals字段没有将file-saver设置为外部排除依赖
  如果你使用monorepo架构，确认file-saver被安装在当前子项目的package.json中，若存在依赖提升异常，可以在package.json中新增nohoist配置包含file-saver包。
第四步：校验项目路径合法性
如果你在Windows系统下运行项目，检查项目根目录完整路径是否包含中文、空格或特殊字符，这类字符会导致Node依赖路径解析失败，将项目移动到全英文无特殊字符的路径下重新启动即可。