Vue3+TS+Vuetify3.1.2报错：Type 'boolean'不可分配给'never'类型

一、排查操作问题 #

1. 确认Vuetify类型声明已正确引入 #

检查项目根目录的tsconfig.json，确保compilerOptions.types包含vuetify：

{
  "compilerOptions": {
    "types": ["vuetify"]
  }
}

同时确认项目的Vuetify插件配置（如vite.config.ts/vue.config.ts）正确，保证TS能识别Vuetify组件的类型定义。

2. 明确绑定ref的类型 #

给绑定v-model的ref显式指定类型，避免TS自动推断时和Vuetify组件类型冲突：

<script setup lang="ts">
import { ref } from 'vue'
const dialogVisible = ref<boolean>(false)
</script>

<template>
  <v-dialog v-model="dialogVisible">
    <!-- 对话框内容 -->
  </v-dialog>
</template>

3. 升级Vuetify版本 #

你使用的Vuetify 3.1.2存在部分TS类型bug，升级到最新稳定版（如3.3.x）可修复多数类型兼容问题。

二、忽略编辑器误报的方法 #

如果确认代码逻辑正常只是编辑器标记错误，可通过以下方式处理：

1. 单行忽略特定错误 #

在报错的组件行上方添加TS注释：

<template>
  <!-- @ts-ignore -->
  <v-dialog v-model="dialogVisible">
    <!-- 对话框内容 -->
  </v-dialog>
</template>

2. 项目级关闭TS实时校验（不推荐全局关闭） #

在项目根目录创建.vscode/settings.json，仅针对当前项目关闭TS校验：

{
  "typescript.validate.enable": false
}

内容的提问来源于stack exchange，提问作者Juan Francisco Porto