在Vue中使用TypeScript的几种方式

 更新时间:2026年05月26日 10:11:38   作者:穆金秋  
本文主要介绍了在Vue中使用TypeScript的几种方式,包括通过<script lang="ts">结合defineComponent,使用Composition API + <script setup lang="ts">和TypeScript定义Props和Emits类型,下面就来详细的介绍一下

Vue中使用TypeScript的几种方式:

  1. 通过<script lang="ts">结合defineComponent;
  2. 推荐使用Composition API + <script setup lang="ts">实现类型推断;
  3. 使用TypeScript定义Props和Emits类型。

配置步骤包括安装依赖、设置tsconfig.json和env.d.ts文件。

使用TypeScript能提供类型安全、更好的IDE支持、清晰的接口定义和更高的代码可维护性。

主流开发工具如VSCode、WebStorm、Vite和Vue CLI都提供良好支持。

在 Vue 中使用 TypeScript 的几种方式

1.使用<script lang="ts">

<template>
  <div>{{ message }}</div>
</template>
<script lang="ts">
import { defineComponent } from 'vue'
export default defineComponent({
  data() {
    return {
      message: 'Hello TypeScript!' as string
    }
  },
  methods: {
    greet(name: string): string {
      return `Hello, ${name}!`
    }
  }
})
</script>

2.使用 Composition API +<script setup lang="ts">(推荐)

<template>
  <div>{{ message }}</div>
  <button @click="increment">Count: {{ count }}</button>
</template>

<script setup lang="ts">
import { ref, computed } from 'vue'

// 类型推断
const count = ref(0) // 自动推断为 Ref<number>
const message = ref('Hello') // 自动推断为 Ref<string>

// 显式类型声明
const user = ref<{ name: string; age: number }>({
  name: 'John',
  age: 25
})

// 类型化的函数
const increment = (amount: number = 1): void => {
  count.value += amount
}

// 计算属性自动推断类型
const doubleCount = computed(() => count.value * 2)
</script>

3.使用 TypeScript 定义 Props

<template>
  <div>{{ title }} - {{ count }}</div>
</template>

<script setup lang="ts">
interface Props {
  title: string
  count?: number
  items: string[]
}

const props = withDefaults(defineProps<Props>(), {
  count: 0
})
</script>

4.类型化的 Emits

<script setup lang="ts">
// 定义 emits 的类型
const emit = defineEmits<{
  (e: 'update', value: number): void
  (e: 'submit', data: { name: string; age: number }): void
}>()

const handleClick = () => {
  emit('update', 10)
  emit('submit', { name: 'John', age: 25 })
}
</script>

配置步骤

1.安装必要的依赖

npm install -D typescript @vue/tsconfig @vue/runtime-dom
# 或
yarn add -D typescript @vue/tsconfig @vue/runtime-dom

2.创建/更新 tsconfig.json

{
  "extends": "@vue/tsconfig/tsconfig.dom.json",
  "include": ["env.d.ts", "src/**/*", "src/**/*.vue"],
  "exclude": ["src/**/__tests__/*"],
  "compilerOptions": {
    "composite": true,
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

3.创建 env.d.ts 文件

/// <reference types="vite/client" />
declare module '*.vue' {
  import type { DefineComponent } from 'vue'
  const component: DefineComponent<{}, {}, any>
  export default component
}

使用 TypeScript 的好处

  • 类型安全:在编译时捕获类型错误
  • 更好的 IDE 支持:自动补全、类型提示、重构
  • 清晰的接口定义:明确的 Props 和 Emits 类型
  • 代码可维护性:类型作为文档,提高代码可读性

常见工具支持

  • VSCode:配合 Volar 插件
  • WebStorm:内置支持
  • Vite:开箱即用
  • Vue CLI:通过 vue add typescript

到此这篇关于在Vue中使用TypeScript的几种方式的文章就介绍到这了,更多相关Vue使用TypeScript内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Vue 集成 storybook的方法

    Vue 集成 storybook的方法

    这篇文章主要介绍了Vue 集成 storybook的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-12-12
  • vue 百度地图(vue-baidu-map)绘制方向箭头折线实例代码详解

    vue 百度地图(vue-baidu-map)绘制方向箭头折线实例代码详解

    这篇文章主要介绍了vue 百度地图(vue-baidu-map)绘制方向箭头折线,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-04-04
  • vue使用event.dataTransfer实现A容器数据拖拽复制到B容器方式

    vue使用event.dataTransfer实现A容器数据拖拽复制到B容器方式

    这篇文章主要介绍了vue使用event.dataTransfer实现A容器数据拖拽复制到B容器方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-02-02
  • vue Watch和Computed的使用总结

    vue Watch和Computed的使用总结

    本文主要介绍Vue.js中监听器和计算属性的相关知识点,包括对普通属性的监听、对对象的监听、对数组的监听,以及计算属性的Set方法,计算属性与监听器的区别等等
    2021-05-05
  • 基于Vue3实现一个简历生成工具

    基于Vue3实现一个简历生成工具

    本文介绍如何从零开始构建一个基于 Vue3 + Markdown 的在线简历生成工具,支持实时编辑预览、模板切换、自定义样式配置以及导出为 PDF,感兴趣的小伙伴可以参考阅读本文
    2025-07-07
  • element-ui中使用upload组件获取上传文件信息

    element-ui中使用upload组件获取上传文件信息

    这篇文章主要介绍了element-ui中使用upload组件获取上传文件信息方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-07-07
  • vue使用element-ui按需引入时踩过的那些坑

    vue使用element-ui按需引入时踩过的那些坑

    Element-UI是基于vue实现的一套不依赖业务的UI组件库,提供了丰富的PC端组件,减少用户对常用组件的封装,降低了开发的难易程度,下面这篇文章主要给大家介绍了关于vue使用element-ui按需引入时踩过的那些坑,需要的朋友可以参考下
    2022-05-05
  • Vue插件从封装到发布的完整步骤记录

    Vue插件从封装到发布的完整步骤记录

    这篇文章主要给大家介绍了关于Vue插件从封装到发布的完整步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-02-02
  • vue3父组件调用子组件方法的思路及实例代码

    vue3父组件调用子组件方法的思路及实例代码

    在Vue.js框架中父子组件之间的通信是常见的需求,其中父组件调用子组件的方法是实现特定功能的重要方式,这篇文章主要介绍了vue3父组件调用子组件方法的相关资料,需要的朋友可以参考下
    2025-06-06
  • Vue文件的组织结构不合理之优化项目结构详解

    Vue文件的组织结构不合理之优化项目结构详解

    在这篇博客中,我们将探讨 Vue 文件组织结构不合理的几个常见问题,并提供解决方案,以帮助开发者创建更清晰、更高效的项目文件结构,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-03-03

最新评论