Strapi v5 出现TS2307类型错误：无法找到@strapi/strapi模块或其对应类型声明

最近我把项目升级到Strapi v5之后，就碰到了这个烦人的TS2307类型错误，提示内容是：

TS2307: Cannot find module '@strapi/strapi' or its corresponding type declarations.

为了排除是原有项目的问题，我特意用CLI命令 npx create-strapi-app@latest 新建了一个完全干净的Strapi项目，结果没想到还是遇到了类似的错误——能看到在src/index.ts文件中导入@strapi/strapi时，代码下方出现红色波浪线，对应的错误提示就是上面那条TS2307。

碰到这种情况，我一般会先尝试这几个排查和解决步骤：

• 首先检查依赖是否安装完整：有时候新建项目可能因为网络波动导致依赖包没装全，试试重新运行 npm install 或者 yarn install，重点确保@strapi/strapi及其相关类型依赖都正确安装
• 确认TS配置文件是否合规：Strapi v5对tsconfig.json有特定要求，检查compilerOptions里的baseUrl和paths配置是否正确，保证TypeScript能正确解析到@strapi/strapi的模块路径
• 清理TS缓存并重启编辑器：TypeScript的缓存偶尔会引发奇怪的解析问题，运行 npx tsc --clearCache 清理缓存，然后重启你的代码编辑器（比如VS Code），让它重新加载项目的类型信息
• 重启TS语言服务：如果用的是VS Code，可以按Ctrl+Shift+P打开命令面板，执行「TypeScript: Restart TS Server」命令，强制类型服务重新扫描整个项目的依赖结构

内容来源于stack exchange