博客摘录「 尚硅谷Vue3入门到实战，最新版Vue3+TypeScript前端开发教程」2024年8月7日

TypeScript+组合式API+setup语法糖1. Vue3简介2020年9月18日，Vue.js发布版3.0版本，代号：One Piece（海贼王）经历了：4800+次提交、40+个RFC、600+次PR、300+贡献者官方发版地址：Release v3.0.0 One Piece · vuejs/core截止2023年10月，最新的公开版本为：3.3.41.1. 【性能的提升】打包大小减少41%。初次渲染快55%, 更新渲染快133%。内存减少54%。1.2.【 源码的升级】使用Proxy代替defineProperty实现响应式。重写虚拟DOM的实现和Tree-Shaking。1.3. 【拥抱TypeScript】Vue3可以更好的支持TypeScript。1.4. 【新的特性】Composition API（组合API）：setupref与reactivecomputed与watch......新的内置组件：FragmentTeleportSuspense......其他改变：新的生命周期钩子data 选项应始终被声明为一个函数移除keyCode支持作为 v-on 的修饰符......2. 创建Vue3工程2.1. 【基于 vue-cli 创建】点击查看官方文档备注：目前vue-cli已处于维护模式，官方推荐基于 Vite 创建项目。## 查看@vue/cli版本，确保@vue/cli版本在4.5.0以上vue --version ## 安装或者升级你的@vue/cli npm install -g @vue/cli ## 执行创建命令vue create vue_test ## 随后选择3.x## Choose a version of Vue.js that you want to start the project with (Use arrow keys)## > 3.x## 2.x ## 启动cd vue_testnpm run serve2.2. 【基于 vite 创建】(推荐)vite 是新一代前端构建工具，官网地址：https://vitejs.cn，vite的优势如下：轻量快速的热重载（HMR），能实现极速的服务启动。对 TypeScript、JSX、CSS 等支持开箱即用。真正的按需编译，不再等待整个应用编译完成。webpack构建 与 vite构建对比图如下： webpack构建：vite构建： 具体操作如下（点击查看官方文档）## 1.创建命令npm create vue@latest ## 2.具体配置## 配置项目名称√ Project name: vue3_test## 是否添加TypeScript支持√ Add TypeScript? Yes## 是否添加JSX支持√ Add JSX Support? No## 是否添加路由环境√ Add Vue Router for Single Page Application development? No## 是否添加pinia环境√ Add Pinia for state management? No## 是否添加单元测试√ Add Vitest for Unit Testing? No## 是否添加端到端测试方案√ Add an End-to-End Testing Solution? >> No## 是否添加ESLint语法检查√ Add ESLint for code quality? Yes## 是否添加Prettiert代码格式化√ Add Prettier for code formatting? No 项目介绍：总结：Vite 项目中，index.html 是项目的入口文件，在项目最外层。加载index.html后，Vite 解析 <script type="module" src="xxx"> 指向的JavaScript。Vue3**中是通过 **createApp 函数创建一个应用实例。 createApp 在创建应用，每一个应用都有一个根组件，根组件就是APP，创建完了这个成功摆在id为APP的div里。这个div在index.html里2.3. 【一个简单的效果】 Vue3向下兼容Vue2语法，且Vue3中的模板中可以没有根标签<template> <div class="person"> <h2>姓名：{{name}}</h2> <h2>年龄：{{age}}</h2> <button @click="changeName">修改名字</button> <button @click="changeAge">年龄+1</button> <button @click="showTel">点我查看联系方式</button> </div></template> <script lang="ts"> export default { name:'App', data() { return { name:'张三', age:18, tel:'13888888888' } }, methods:{ changeName(){ this.name = 'zhang-san' }, changeAge(){ this.age += 1 }, showTel(){ alert(this.tel) } }, }</script>3. Vue3核心语法3.1. 【OptionsAPI 与 CompositionAPI】Vue2的API设计是Options（配置）风格的。Vue3的API设计是Composition（组合）风格的。Options API 的弊端Options类型的 API，数据、方法、计算属性等，是分散在：data、methods、computed中的，若想新增或者修改一个需求，就需要分别修改：data、methods、computed，不便于维护和复用。Composition API 的优势可以用函数的方式，更加优雅的组织代码，让相关功能的代码更加有序的组织在一起。 3.2. 【拉开序幕的 setup】setup 概述setup是Vue3中一个新的配置项，值是一个函数，它是 Composition API "表演的舞台"，组件中所用到的：数据、方法、计算属性、监视......等等，均配置在setup中。特点如下：setup函数返回的对象中的内容，可直接在模板中使用。setup中访问this是undefined。setup函数会在beforeCreate之前调用，它是"领先"所有钩子执行的。<template> <div class="person"> <h2>姓名：{{name}}</h2> <h2>年龄：{{age}}</h2> <button @click="changeName">修改名字</button> <button @click="changeAge">年龄+1</button> <button @click="showTel">点我查看联系方式</button> </div></template> <script lang="ts"> export default { name:'Person', setup(){ // 数据，原来写在data中（注意：此时的name、age、tel数据都不是响应式数据） let name = '张三' let age = 18 let tel = '13888888888' // 方法，原来写在methods中 function changeName(){ name = 'zhang-san' //注意：此时这么修改name页面是不变化的 console.log(name) } function changeAge(){ age += 1 //注意：此时这么修改age页面是不变化的 console.log(age) } function showTel(){ alert(tel) } // 返回一个对象，对象中的内容，模板中可以直接使用 return {name,age,tel,changeName,changeAge,showTel} } }</script>setup 的返回值若返回一个对象：则对象中的：属性、方法等，在模板中均可以直接使用**（重点关注）。**若返回一个函数：则可以自定义渲染内容，代码如下：setup(){ return ()=> '你好啊！'}setup 与 Options API 的关系Vue2 的配置（data、methos......）中可以访问到 setup中的属性、方法。(旧语法可以读取到新语法)但在setup中不能访问到Vue2的配置（data、methos......）。//setup不能用this如果与Vue2冲突，则setup优先。setup 语法糖setup函数有一个语法糖，这个语法糖，可以让我们把setup独立出去，代码如下：<template> <div class="person"> <h2>姓名：{{name}}</h2> <h2>年龄：{{age}}</h2> <button @click="changName">修改名字</button> <button @click="changAge">年龄+1</button> <button @click="showTel">点我查看联系方式</button> </div></template> <script lang="ts"> export default { name:'Person', }</script> <!-- 下面的写法是setup语法糖 --><script setup lang="ts"> console.log(this) //undefined // 数据（注意：此时的name、age、tel都不是响应式数据） let name = '张三' let age = 18 let tel = '13888888888' // 方法 function changName(){ name = '李四'//注意：此时这么修改name页面是不变化的 } function changAge(){ console.log(age) age += 1 //注意：此时这么修改age页面是不变化的 } function showTel(){ alert(tel) }</script>扩展：上述代码，还需要编写一个不写setup的script标签，去指定组件名字，比较麻烦，我们可以借助vite中的插件简化第一步：npm i vite-plugin-vue-setup-extend -D<template><div class="person"><h2>汽车信息：一辆{{car.brand}}车，价值{{car.price}}万</h2><button @click="changebrand">修改车的品牌</button><button @click="changePrice">修改车的价格</button><button @click="changeCar">修改车的信息</button></div></template> <!-- 下面的写法是setup语法糖 --><script setup lang="ts" name="Person666">import {reactive,ref} from "vue"; console.log(this) //undefined // 数据（注意：此时的name、age、tel都不是响应式数据）// let car = reactive({brand:'奔驰',price:100})let car = ref({brand:'奔驰',price:100})// 方法function changebrand(){car.value.brand ='宝马'}function changePrice(){car.value.price +=10}function changeCar(){// Object.assign(car,{brand:'奥托',price:1})car.value= {brand:'奥托666',price:666}} </script>第二步：vite.config.tsimport { defineConfig } from 'vite'import VueSetupExtend from 'vite-plugin-vue-setup-extend' export default defineConfig({ plugins: VueSetupExtend() })3.第三步：<script setup lang="ts" name="Person">3.3. 【ref 创建：基本类型的响应式数据】**作用：**定义响应式变量。语法：let xxx = ref(初始值)。**返回值：**一个RefImpl的实例对象，简称ref对象或ref，ref对象的value属性是响应式的。注意点：tS中操作数据需要：xxx.value，但模板中不需要.value，直接使用即可。何时需要.value？模板中不需要；包裹在响应式对象里面的ref不需要；未包裹的ref需要。对于let name = ref('张三')来说，name不是响应式的，name.value是响应式的。<template> <div class="person"> <h2>姓名：{{name}}</h2> <h2>年龄：{{age}}</h2> <button @click="changeName">修改名字</button> <button @click="changeAge">年龄+1</button> <button @click="showTel">点我查看联系方式</button> </div></template> <script setup lang="ts" name="Person"> import {ref} from 'vue' // name和age是一个RefImpl的实例对象，简称ref对象，它们的value属性是响应式的。 let name = ref('张三') let age = ref(18) // tel就是一个普通的字符串，不是响应式的 let tel = '13888888888' function changeName(){ // JS中操作ref对象时候需要.value name.value = '李四' console.log(name.value) // 注意：name不是响应式的，name.value是响应式的，所以如下代码并不会引起页面的更新。 // name = ref('zhang-san') } function changeAge(){ // JS中操作ref对象时候需要.value age.value += 1 console.log(age.value) } function showTel(){ alert(tel) }</script>3.4. 【reactive 创建：对象类型的响应式数据】作用：定义一个响应式对象（基本类型不要用它，要用ref，否则报错）语法：let 响应 式对象= reactive(源对象)。**返回值：**一个Proxy的实例对象，简称：响应式对象。注意点：reactive定义的响应式数据是"深层次"的。<template> <div class="person"> <h2>汽车信息：一台{{ car.brand }}汽车，价值{{ car.price }}万</h2> <h2>游戏列表：</h2> <ul> <li v-for="g in games" :key="g.id">{{ g.name }}</li> </ul> <h2>测试：{{obj.a.b.c.d}}</h2> <button @click="changeCarPrice">修改汽车价格</button> <button @click="changeFirstGame">修改第一游戏</button> <button @click="test">测试</button> </div></template> <script lang="ts" setup name="Person">import { reactive } from 'vue' // 数据let car = reactive({ brand: '奔驰', price: 100 })let games = reactive( { id: 'ahsgdyfa01', name: '英雄联盟' }, { id: 'ahsgdyfa02', name: '王者荣耀' }, { id: 'ahsgdyfa03', name: '原神' })let obj = reactive({ a:{ b:{ c:{ d:666 } } }}) function changeCarPrice() { car.price += 10}function changeFirstGame() { games0.name = '流星蝴蝶剑'}function test(){ obj.a.b.c.d = 999}</script>3.5. 【ref 创建：对象类型的响应式数据】其实ref接收的数据可以是：基本类型、对象类型。若ref接收的是对象类型，内部其实也是调用了reactive函数。<template> <div class="person"> <h2>汽车信息：一台{{ car.brand }}汽车，价值{{ car.price }}万</h2> <h2>游戏列表：</h2> <ul> <li v-for="g in games" :key="g.id">{{ g.name }}</li> </ul> <h2>测试：{{obj.a.b.c.d}}</h2> <button @click="changeCarPrice">修改汽车价格</button> <button @click="changeFirstGame">修改第一游戏</button> <button @click="test">测试</button> </div></template> <script lang="ts" setup name="Person">import { ref } from 'vue' // 数据let car = ref({ brand: '奔驰', price: 100 })let games = ref( { id: 'ahsgdyfa01', name: '英雄联盟' }, { id: 'ahsgdyfa02', name: '王者荣耀' }, { id: 'ahsgdyfa03', name: '原神' })let obj = ref({ a:{ b:{ c:{ d:666 } } }}) console.log(car) function changeCarPrice() { car.value.price += 10}function changeFirstGame() { games.value0.name = '流星蝴蝶剑'}function test(){ obj.value.a.b.c.d = 999}</script>3.6. 【ref 对比 reactive】宏观角度看：ref用来定义：基本类型数据、对象类型数据；reactive用来定义：对象类型数据。区别：ref创建的变量必须使用.value（可以使用volar插件自动添加.value）。 reactive重新分配一个新对象，会失去响应式（可以使用Object.assign去整体替换）。 Object.assign(car, { brand: '奥拓', price: 1 })<template> <div class="person"> <h2>汽车信息：一辆{{car.brand}}车，价值{{car.price}}万</h2> <button @click="changebrand">修改车的品牌</button> <button @click="changePrice">修改车的价格</button> <button @click="changeCar">修改车的信息</button> </div></template> <!-- 下面的写法是setup语法糖 --><script setup lang="ts" name="Person666">import {reactive,ref} from "vue"; console.log(this) //undefined // 数据（注意：此时的name、age、tel都不是响应式数据）// let car = reactive({brand:'奔驰',price:100})let car = ref({brand:'奔驰',price:100})// 方法function changebrand(){ car.value.brand ='宝马'}