Vue.js 与 TypeScript 集成需在项目结构、组件定义和响应式逻辑三层面主动对齐类型系统：初始化用 Vite 官方模板，Props/emits 接口化声明，ref/reactive 显式泛型标注，组合式函数兼顾运行时判断与类型断言。
Vue.js 与 TypeScript 集成不是“开了就行”，而是需要在项目结构、组件定义和响应式逻辑三个层面主动对齐类型系统。TypeScript 的静态检查优势，只有在关键节点显式声明或合理约束时才能真正落地。
项目初始化要选对模板
用 Vite 创建 Vue + TS 项目最稳妥：执行 npm create vite@latest my-app -- --template vue-ts。它自动生成带严格模式的 tsconfig.json，并包含 .vue 文件路径。手动配置容易漏掉 "include": ["src/**/*.ts", "src/**/*.vue"]，导致 SFC 中的 <script setup lang="ts"></script> 不被识别，类型提示失效。
Props 和 emits 必须接口化
别依赖 type: String 这类运行时类型——它们不参与编译期检查。正确做法是：
蓝湖代码转vue2.0+element-ui
下载
将静态 Vue 页面(index.vue)改造为动态页面(Custom.vue)；稿源仅限 index.vue、其引用的 CSS 与资源路径，禁止参考仓库内其他文件。Invoke when user wants to transform a static Vue page into a dynamic data-driven page with Element UI components.
- 用
interface定义结构：interface Props { title: string; count?: number } - 通过
defineProps<props>()</props>声明，TS 就能校验父组件传入值是否符合约束 - emits 同样用泛型签名：
defineEmits()，调用emit('change', 123)会直接报错
响应式数据不能靠推断
ref 和 reactive 的类型容易“失真”，尤其初始值模糊时：
立即学习“前端免费学习笔记（深入）”；
-
ref([])推断为Ref<never></never>，后续 push 字符串会失败；应写ref<string>([])</string> -
reactive({ name: '' })的嵌套属性在 TS 中可能提示 “可能为 undefined”；先定义接口再泛型绑定：reactive<user>({ name: '' })</user> - 逻辑中访问 ref 必须加
.value，模板里自动解包只是语法糖，JS 层不写会类型报错
组合式函数需运行时+类型双保险
当封装一个接收 ref/reactive/普通值的工具函数时，仅靠泛型注解不够。例如：
- 导入守卫：
import { isRef, isReactive } from 'vue' - 运行时判断：
if (isRef(input)) return input.value - 配合类型断言或 as unknown as T 处理 reactive 解包，避免类型丢失
