Vue+Quasar项目安装Pinia后提示找不到模块及类型声明如何解决

Vue + Quasar 项目将状态管理从 Vuex 切换为 Pinia，已完成 Pinia 安装操作，PyCharm 持续抛出类型报错：

Cannot find module 'pinia' or its corresponding type declarations

按以下顺序逐一排查，每步操作后检查报错是否消除：

• 校验依赖安装状态：在项目根目录执行 npm ls pinia，如果命令返回结果中没有pinia的版本信息，说明依赖未正确安装到当前项目本地，执行 npm install pinia（使用yarn则执行yarn add pinia，使用pnpm则执行pnpm add pinia）重新安装即可。注意不要只在全局环境安装Pinia，IDE默认不会读取全局node_modules下的类型声明文件。
• 重启IDE的TypeScript索引服务：在PyCharm中按下 Ctrl+Shift+A（macOS系统对应快捷键为Cmd+Shift+A）调出动作搜索栏，输入Restart TypeScript Service后选中执行，等待TS服务重启完成重新索引依赖即可，这类模块找不到的报错80%以上是TS服务索引异常导致的。
• 核对TS配置文件：打开项目根目录的tsconfig.json（JS项目对应为jsconfig.json），确认compilerOptions.moduleResolution字段值为bundler（适配Quasar/Vite构建场景）或node，同时确认include字段的路径覆盖了编写Pinia导入语句的业务文件，不要误将node_modules加入exclude配置项。
• 清缓存重装依赖：如果以上操作都无效，删除项目根目录下的node_modules文件夹和对应包管理器的锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml），重新执行依赖安装命令完成全量重装，之后重启PyCharm等待全量索引结束即可。
• Quasar项目特殊适配：如果是Quasar CLI创建的项目，优先使用官方扩展安装Pinia，执行 quasar ext add @quasar/pinia 即可，官方扩展会自动完成Pinia的挂载、类型注入配置，避免手动安装时的配置漏项问题。

内容的提问来源于stack exchange，提问作者Nathan Wailes