Nuxt3集成Pinia启动报错：找不到pinia/dist/pinia.mjs模块

问题场景 #

在全新Nuxt3项目中按以下步骤配置Pinia：

• 执行npx nuxi init nuxt-app初始化项目
• 进入项目目录cd nuxt-app
• 安装基础依赖npm install
• 安装@pinia/nuxt：npm install @pinia/nuxt
• 启动开发服务器正常，但在nuxt.config.ts中添加modules: ["@pinia/nuxt"]配置后，重启服务报错：

ERROR Cannot start nuxt: Cannot find module 'pinia/dist/pinia.mjs'

解决步骤 #

1. 重新安装完整Pinia依赖
   卸载现有@pinia/nuxt后，同时安装核心包与Nuxt适配模块：

   npm uninstall @pinia/nuxt
   npm install pinia @pinia/nuxt
   

2. 确认配置文件无误
   确保nuxt.config.ts中的配置如下：

   export default defineNuxtConfig({
     modules: ["@pinia/nuxt"]
   });
   

3. 清理依赖环境重试（若步骤1无效）

   • 删除node_modules文件夹：
     Windows：rd /s /q node_modules
     macOS/Linux：rm -rf node_modules
   • 删除锁文件：
     Windows：del package-lock.json
     macOS/Linux：rm package-lock.json
   • 清理npm缓存：npm cache clean --force
   • 重新安装所有依赖：npm install

4. 重启开发服务器

   npm run dev
   

原因说明 #

@pinia/nuxt是Pinia针对Nuxt的适配模块，它依赖pinia核心包，但部分情况下自动安装逻辑会遗漏核心包，导致启动时找不到对应的文件，手动安装pinia即可解决。

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