Nuxt 3扩展项目时出现模块未找到错误，求解决方案

你遇到的这个模块找不到错误，本质是Nuxt 3的extends机制在依赖解析上的特性导致的——默认情况下，主项目不会自动识别或加载扩展项目的依赖，哪怕你把扩展项目移到主项目目录里也一样。下面是具体的排查和解决步骤：

1. 先确保扩展项目的依赖已正确安装 #

不管扩展项目在哪个位置，首先要进入test-extend目录，运行你的包管理器命令安装依赖：

# npm
npm install

# pnpm
pnpm install

# yarn
yarn install

很多时候这个错误只是因为扩展项目本身的依赖没装，主项目自然找不到对应的模块。

2. 配置主项目的依赖解析路径 #

如果扩展项目的依赖已经安装，但主项目还是找不到，那需要让Nuxt知道去扩展项目的node_modules里查找依赖。在main-project的nuxt.config.ts中添加resolve.modulesDir配置：

export default defineNuxtConfig({
  extends: ['../test-extend'], // 或者你移动后的路径，比如'./test-extend'
  resolve: {
    modulesDir: ['../test-extend/node_modules', 'node_modules']
    // 如果已经把test-extend移到main-project内，路径改成'./test-extend/node_modules'
  }
})

这个配置会让Nuxt优先去扩展项目的依赖目录查找模块，再回退到主项目自己的node_modules。

3. 用本地依赖的方式引入扩展项目（可选） #

如果上面的方法还是不行，可以把test-extend当作主项目的本地依赖来处理：

1. 在main-project的package.json中添加本地依赖声明：

"dependencies": {
  "test-extend": "file:../test-extend"
}

2. 运行包管理器安装这个本地依赖：

npm install

这种方式会让包管理器自动处理依赖的解析，Nuxt也能正确识别扩展项目的配置和依赖。

为什么移到主项目内还是不行？ #

哪怕把test-extend放到main-project目录下，Nuxt默认也不会去子目录的node_modules里查找依赖，它只会扫描主项目根目录的node_modules。所以必须通过上面的配置告诉Nuxt额外的依赖查找路径，或者用本地依赖的方式让包管理器帮你处理。

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