Vue 3 + TypeScript 从入门到进阶：快速上手指南

Vue 3 是 Vue.js 的最新版本，而 TypeScript 是一种可以极大提升开发效率和代码质量的强类型语言。当 Vue 3 与 TypeScript 结合使用时，可以带来更高效的开发体验。本文将重点介绍 Vue 3 与 TypeScript 的结合使用方式，并提供详细的代码示例。

一、为什么选择 TypeScript？

TypeScript 的主要优势包括：

• 类型安全：通过静态类型检查，减少运行时错误。
• IDE 支持：自动补全、类型提示等功能提升开发效率。
• 更易维护：清晰的类型定义有助于多人协作。

在 Vue 3 中，使用 TypeScript 可以更好地描述组件的 Props、Emit 和数据结构。

二、快速开始 Vue 3 + TypeScript 项目

1. 使用 Vite 创建项目

安装 Vite：

npm create vite@latest my-vue3-ts-app -- --template vue-ts
cd my-vue3-ts-app
npm install
npm run dev

2. 项目结构

• src/：存放主要的项目代码。
• main.ts：项目入口文件，配置 Vue 实例。
• vite.config.ts：Vite 配置文件。

示例主文件：

import { createApp } from 'vue';
import App from './App.vue';

createApp(App).mount('#app');

三、Vue 3 中使用 TypeScript 的核心概念

1. 定义组件

使用 defineComponent 定义组件可以提供类型推导支持。

示例：

<script lang="ts">
import { defineComponent, ref } from 'vue';

export default defineComponent({
  name: 'MyComponent',
  setup() {
    const message = ref<string>('Hello, Vue 3 + TypeScript!');

    return { message };
  },
});
</script>

<template>
  <h1>{{ message }}</h1>
</template>

2. Props 类型定义

在 Vue 3 中，可以通过接口定义 Props 的类型。

示例：

<script lang="ts">
import { defineComponent } from 'vue';

type Props = {
  title: string;
  count: number;
};

export default defineComponent({
  props: {
    title: String,
    count: Number,
  },
  setup(props: Props) {
    return { props };
  },
});
</script>

<template>
  <h1>{{ props.title }}: {{ props.count }}</h1>
</template>

3. Emit 类型定义

为事件的触发定义类型。

示例：

<script lang="ts">
import { defineComponent } from 'vue';

type Emit = (event: 'update', payload: number) => void;

export default defineComponent({
  emits: ['update'],
  setup(_, { emit }: { emit: Emit }) {
    const updateCount = (value: number) => {
      emit('update', value);
    };

    return { updateCount };
  },
});
</script>

<template>
  <button @click="updateCount(10)">Update Count</button>
</template>

4. 使用泛型定义复杂类型

在处理复杂数据结构时，可以通过 TypeScript 的泛型提升代码灵活性。

示例：

<script lang="ts">
import { defineComponent, ref } from 'vue';

type Todo = {
  id: number;
  text: string;
  completed: boolean;
};

export default defineComponent({
  setup() {
    const todos = ref<Todo[]>([]);

    const addTodo = (text: string) => {
      todos.value.push({ id: Date.now(), text, completed: false });
    };

    return { todos, addTodo };
  },
});
</script>

<template>
  <div>
    <ul>
      <li v-for="todo in todos" :key="todo.id">
        {{ todo.text }}
      </li>
    </ul>
    <button @click="addTodo('Learn TypeScript')">Add Todo</button>
  </div>
</template>

四、Vue 3 + TypeScript 的最佳实践

1. 使用类型接口

为组件的 Props、State 和 Emit 定义类型接口，提升代码的可读性和可维护性。

2. 配置 IDE 和 ESLint

• 确保使用支持 TypeScript 的编辑器（如 VS Code）。
• 配置 ESLint 规则，避免类型错误。

示例 ESLint 配置：

{
  "extends": [
    "plugin:vue/vue3-recommended",
    "@vue/typescript/recommended"
  ]
}

3. 合理使用泛型

在处理复杂数据结构时，使用泛型定义通用类型，提升代码的复用性。

4. 结合 Vuex 或 Pinia

使用 TypeScript 定义 Vuex 或 Pinia 的状态和操作，确保状态管理逻辑更加健壮。

五、结语

Vue 3 和 TypeScript 的结合为前端开发提供了强大的工具链支持，可以显著提升开发效率和代码质量。希望本文能够帮助你快速掌握 Vue 3 和 TypeScript 的使用技巧！

关注我，获取更多 Vue 3 + TypeScript 开发技巧！