unplugin-vue-components 不能识别组件的自动导入的类型 (pnpm)

引言

unplugin-vue-components 是一款能帮助组件自动导入的库，简单点的说，你不需要使用import xx from 'xxx.vue' 这行语句也能实现导入的效果。

<script setup lang="ts">
import ScreenAdpter from '@compontents/ScreenAdpter/index.vue'
import Play from '@components/Play/index.vue'

</script>

<template>
    <ScreenAdpter>
        <Play></Play>
    </ScreenAdpter>
</template>

<style scoped></style>

等同于以下效果

<script setup lang="ts">
</script>

<template>
    <ScreenAdpter>
        <Play></Play>
    </ScreenAdpter>
</template>

<style scoped></style>

效果

这里需要实现的效果如下：

发现问题

但是问题来了，使用pnpm的用户，我相信许多人是实现不了这上效果的😀😀😀。当所有的配置文件配好，然后就出现下面的效果啦！！！

问题效果

你会发现，在组件使用的地方的类型是any, 当你去unplugin-vue-components 这里面点击组件是可以进去的，那么怎么来解决这个引用问题呢？

解决问题

刨根问底

既然组件显示的类型是any,那么咱们先看下生产的类型声明文件。

// generated by unplugin-vue-components
// We suggest you to commit this file into source control
// Read more: types(defineComponent): support for expose component types by pikax · Pull Request #3399 · vuejs/core
import '@vue/runtime-core'

export {}

declare module '@vue/runtime-core' {
  export interface GlobalComponents {
    Play: typeof import('./components/Play/index.vue')['default']
    RouterLink: typeof import('vue-router')['RouterLink']
    RouterView: typeof import('vue-router')['RouterView']
    ScreenAdpter: typeof import('./components/ScreenAdpter/index.vue')['default']
  }
}

在自动生成的components.d.ts文件中的 declare module '@vue/runtime-core' 声明，在 pnpm 中只能访问项目的顶级依赖，而 @vue/runtime-core 是 vue 模块下的依赖，不是顶级依赖，导致声明语句失效。（yarn 和 npm 的 node_modules 平铺目录结构允许访问所有依赖）

解决方案

1. 🌟 （首选）在目录的根目录中创建或编辑.npmrc文件，并在其中添加以下行：public hoist pattern[]=@vue/runtime core

2. （不推荐）在目录的根目录中创建或编辑.npmrc文件，并在其中添加以下行：shamefully-hoist=true（这样做将使所有嵌套依赖项都可用作顶级依赖项）

3. （不推荐）运行pnpm add@vue/runtime core -D将嵌套模块添加为顶级依赖项。（您必须确保@vue/runtime内核的版本与项目中安装的vue版本相匹配。）

4. （不推荐）使用0.18.5版本的unplugin-vue-components组件，而不是最新版本。（之所以有效，是因为在此版本之前，unplugin-vue-components 组件将components.d.ts中的模块声明为“vue”。缺点是，您将错过插件的最新更新和改进。）

5. （不建议）手动更新components.d.ts中的模块声明名称，以声明模块“vue”，而不是声明模块“@vue/runtime core”（这很不方便，因为每当取消插入vue组件自动生成新的components.d.ts文件并覆盖您的更改时，您都必须更新模块名称。）

注意：
如果您选择了选项1或2并创建了.npmrc文件，请在之后运行pnpm i以使用最新的配置更新node_modules。然后，重新加载工作区。自动导入组件的Intellisense应再次工作。

如果这么操作还是不行，就重启下vscode就ok啦

祝福

即将接近2022年除夕啦，小编在这里祝福大家在新的一年里，新年快乐，心想事成，万事如意，代码永无bugger🎉🎉🎉🎉

unplugin-vue-components