导入BootstrapVue 3时出现TypeScript类型错误求助

问题代码与错误信息 #

项目中引入BootstrapVue3的代码如下：

import { createApp } from "vue";
import App from "./App.vue";
import BootstrapVue3 from "bootstrap-vue-3"

import 'bootstrap/dist/css/bootstrap.css'
import 'bootstrap-vue-3/dist/bootstrap-vue-3.css'

const app = createApp(App);

app.use(BootstrapVue3);

app.mount("#app");

执行到app.use(BootstrapVue3);时触发TypeScript类型错误：

上述代码中的指定行引发了如下错误

app.use(BootstrapVue3);

Argument of type 'Plugin_2<any[]>' is not assignable to parameter of type 'Plugin_2'.
  Type '((app: App<any>, ...options: any[]) => any) & { install?: ((app: App<any>, ...options: any[]) => any) | undefined; }' is not assignable to type 'Plugin_2'.

解决方法 #

1. 类型断言绕过检查 #

直接给BootstrapVue3添加类型断言，明确告诉TypeScript它符合Vue插件类型：

app.use(BootstrapVue3 as unknown as import('vue').Plugin);

2. 校验版本兼容性 #

确保BootstrapVue3和Vue 3版本匹配。查看BootstrapVue3官方文档确认支持的Vue版本，然后执行命令更新：

# 更新Vue至兼容版本
npm update vue
# 重新安装BootstrapVue3
npm install bootstrap-vue-3

3. 补充类型定义（若缺失） #

如果项目缺少BootstrapVue3的类型声明，尝试安装对应的@types包：

npm install @types/bootstrap-vue-3 --save-dev

注：bootstrap-vue-3本身已内置类型，此步骤仅在类型文件缺失时使用。

4. 临时跳过库类型检查（不推荐长期用） #

修改tsconfig.json，开启skipLibCheck跳过第三方库的类型检查：

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

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