Vue3入门

关注

原创最新推荐文章于 2026-02-20 09:24:29 发布 918 阅读 AI 写同款· GEO 优化 ›

全网最全的vue3入门教程『图文并茂』 Vue 3 是一个流行的开源JavaScript框架，用于构建用户界面和单页面应用。它带来了许多新特性和改进，包括更好的性能、更小的打包大小、更好的TypeScript支持、全新的组合式 API，以及一些新的内置组件。你可以创建自定义的hooks来复用代码。一个自定义hook就是一个函数，它可以使用其他的响应式数据和组合式API。import {setup() {你可以使用customRef函数来创建一个自定义的响应式引用。这允许你控制和观察当引用的值发生变化时的行为。阅读详情

认识 Vue3

1. Vue3组合式API体验

通过 Counter 案例体验Vue3新引入的组合式API

<script>
export default {
  data(){
    return {
      count:0
    }
  },
  methods:{
    addCount(){
      this.count++
    }
  }
}
</script>

<script setup>
import { ref } from 'vue'
const count = ref(0)
const addCount = ()=> count.value++
</script>

特点：

代码量变少
分散式维护变成集中式维护

2. Vue3更多的优势

使用create-vue搭建Vue3项目

1. 认识create-vue

create-vue是Vue官方新的脚手架工具，底层切换到了 vite (下一代前端工具链)，为开发提供极速响应

2. 使用create-vue创建项目

前置条件 - 已安装16.0或更高版本的Node.js

执行如下命令，这一指令将会安装并执行 create-vue

npm init vue@latest
//npm init vue@3.6.0

熟悉项目和关键文件

组合式API - setup选项

1. setup选项的写法和执行时机

写法

<script>
  export default {
    setup(){
      
    },
    beforeCreate(){
      
    }
  }
</script>

执行时机

在beforeCreate钩子之前执行

2. setup中写代码的特点

在setup函数中写的数据和方法需要在末尾以对象的方式return，才能给模版使用

<script>
  export default {
    setup(){
      const message = 'this is message'
      const logMessage = ()=>{
        console.log(message)
      }
      // 必须return才可以
      return {
        message,
        logMessage
      }
    }
  }
</script>

3. <script setup>语法糖

script标签添加 setup标记，不需要再写导出语句，默认会添加导出语句

<script setup>
  const message = 'this is message'
  const logMessage = ()=>{
    console.log(message)
  }
</script>

小结

1. setup选项的执行时机？ beforeCreate钩子之前自动执行

2. setup写代码的特点是什么？定义数据 + 函数然后以对象方式return

3. <script setup>解决了什么问题？经过语法糖的封装更简单的使用组合式API

4. setup中的this还指向组件实例吗？指向undefined

组合式API - reactive和ref函数

1. reactive

接受对象类型数据的参数传入并返回一个响应式的对象

<script setup>
 // 导入
 import { reactive } from 'vue'
 // 执行函数 传入参数 变量接收
 const state = reactive({
   msg:'this is msg'
 })
 const setSate = ()=>{
   // 修改数据更新视图
   state.msg = 'this is new msg'
 }
</script>
<template>
  {{ state.msg }}
  <button @click="setState">change msg</button>
</template>

2. ref

接收简单类型或者对象类型的数据传入并返回一个响应式的对象

<script setup>
 // 导入
 import { ref } from 'vue'
 // 执行函数 传入参数 变量接收
 const count = ref(0)
 const setCount = ()=>{
   // 修改数据更新视图必须加上.value
   count.value++
 }
</script>
<template>
  <button @click="setCount">{{count}}</button>
</template>

3. reactive 对比 ref

都是用来生成响应式数据
不同点
1. reactive不能处理简单类型的数据
2. ref参数类型支持更好，但是必须通过.value做访问修改
3. ref函数内部的实现依赖于reactive函数
在实际工作中的推荐
1. 推荐使用ref函数，减少记忆负担，小兔鲜项目都使用ref

小结

1. reactive和ref函数的共同作用是什么？

用函数调用的方式生成响应式数据

2. reactive vs ref ？

<1>reactive不能处理简单类型的数据

<2>ref参数类型支持更好但是必须通过.value访问修改

<3>ref函数的内部实现依赖于reactive函数

3. 在实际工作中推荐使用哪个？

推荐使用ref函数，更加灵活，小兔鲜项目主用ref

组合式API - computed

计算属性基本思想和Vue2的完全一致，组合式API下的计算属性只是修改了写法

核心步骤：

1. 导入computed函数

2. 执行函数在回调参数中return基于响应式数据做计算的值，用变量接收

<script setup>
// 原始响应式数组
import { ref, computed } from 'vue'

const list = ref([1, 2, 3, 4, 5, 6, 7, 8])

// 计算属性数组：过滤出大于 2 的元素
const computedList = computed(() => {
  return list.value.filter(item => item > 2)
})

// 3秒后向原始数组添加新元素
setTimeout(() => {
  list.value.push(9, 10)
}, 3000)
</script>

<template>
  <div>
    原始响应式数组 - {{ list }}
  </div>
  <div>
    计算属性数组 - {{ computedList }}
  </div>
</template>

最佳实践

1. 计算属性中不应该有“副作用”

比如异步请求/修改dom

2. 避免直接修改计算属性的值

计算属性应该是只读的

组合式API - watch

侦听一个或者多个数据的变化，数据变化时执行回调函数

俩个额外参数： immediate控制立刻执行，deep开启深度侦听

1. 侦听单个数据

导入watch函数
执行watch函数传入要侦听的响应式数据(ref对象)和回调函数

<script setup>
  // 1. 导入watch
  import { ref, watch } from 'vue'
  const count = ref(0)
  // 2. 调用watch 侦听变化
  watch(count, (newValue, oldValue)=>{
    console.log(`count发生了变化，老值为${oldValue},新值为${newValue}`)
  })
</script>

2. 侦听多个数据

同时侦听多个响应式数据的变化，不管哪个数据变化都需要执行回调

侦听多个数据，第一个参数可以改写成数组的写法

<script setup>
  // 1. 导入watch
  import { ref, watch } from 'vue'
  const count = ref(0)
  const name = ref('cp')
  // 2. 调用watch 侦听变化
  watch([count, name], ([newCount, newName],[oldCount,oldName])=>{
    console.log(`count或者name变化了，[newCount, newName],[oldCount,oldName])
  })
</script>

3. immediate

在侦听器创建时立即出发回调，响应式数据变化之后继续执行回调

<script setup>
  // 1. 导入watch
  import { ref, watch } from 'vue'
  const count = ref(0)
  // 2. 调用watch 侦听变化
  watch(count, (newValue, oldValue)=>{
    console.log(`count发生了变化，老值为${oldValue},新值为${newValue}`)
  },{
    immediate: true
  })
</script>

4. deep

通过watch监听的ref对象默认是浅层侦听的，直接修改嵌套的对象属性不会触发回调执行，需要开启deep

<script setup>
  // 1. 导入watch
  import { ref, watch } from 'vue'
  const state = ref({ count: 0 })
  // 2. 监听对象state
  watch(state, ()=>{
    console.log('数据变化了')
  })
  const changeStateByCount = ()=>{
    // 直接修改不会引发回调执行
    state.value.count++
  }
</script>

<script setup>
  // 1. 导入watch
  import { ref, watch } from 'vue'
  const state = ref({ count: 0 })
  // 2. 监听对象state 并开启deep
  watch(state, ()=>{
    console.log('数据变化了')
  },{deep:true})
  const changeStateByCount = ()=>{
    // 此时修改可以触发回调
    state.value.count++
  }
</script>

5. 精确侦听对象的某个属性

需求：在不开启deep的前提下，侦听age的变化，只有age变化时才执行回调

<script setup>
import { ref, watch } from 'vue'
const info = ref({
  name: 'cp',
  age: 18
})
watch(
  () => info.value.age, // 用函数返回要监听的属性
  (newVal, oldVal) => {
    console.log('age发生变化了', '新值:', newVal, '旧值:', oldVal)
  }
)
</script>

小结

1. 作为watch函数的第一个参数，ref对象需要添加.value吗？

不需要，watch会自动读取

2. watch只能侦听单个数据吗？

单个或者多个

3. 不开启deep，直接修改嵌套属性能触发回调吗？

不能，默认是浅层侦听

4. 不开启deep，想在某个层次比较深的属性变化时执行回调怎么做？

可以把第一个参数写成函数的写法，返回要监听的具体属性

组合式API - 生命周期函数

1. 选项式对比组合式

选项式 API	组合式 API	说明
`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">beforeCreate</font>`/`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">created</font>`	`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">setup</font>`	组合式 API 中，`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">setup</font>` 函数会在这两个钩子之前执行，替代了它们的作用。
`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">beforeMount</font>`	`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">onBeforeMount</font>`	组件挂载到 DOM 之前触发。
`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">mounted</font>`	`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">onMounted</font>`	组件挂载到 DOM 之后触发，可用于访问 DOM 元素或发起异步请求。
`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">beforeUpdate</font>`	`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">onBeforeUpdate</font>`	组件数据更新、DOM 重新渲染之前触发。
`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">updated</font>`	`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">onUpdated</font>`	组件数据更新、DOM 重新渲染完成之后触发。
`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">beforeUnmount</font>`	`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">onBeforeUnmount</font>`	组件卸载之前触发，可用于清除定时器、取消订阅等。
`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">unmounted</font>`	`<font style="color:rgb(0, 0, 0);background-color:rgba(0, 0, 0, 0);">onUnmounted</font>`	组件卸载完成之后触发。

2. 生命周期函数基本使用

导入生命周期函数
执行生命周期函数，传入回调

<scirpt setup>
import { onMounted } from 'vue'
onMounted(()=>{
  // 自定义逻辑
})
</script>

3. 执行多次

生命周期函数执行多次的时候，会按照顺序依次执行

<scirpt setup>
import { onMounted } from 'vue'
onMounted(()=>{
  // 自定义逻辑
})

onMounted(()=>{
  // 自定义逻辑
})
</script>

小结

1. 组合式API中生命周期函数的格式是什么？ on + 生命周期名字

2. 组合式API中可以使用onCreated吗？没有这个钩子函数，直接写到setup中

3. 组合式API中组件卸载完毕时执行哪个函数？ onUnmounted

组合式API - 父子通信

1. 父传子

基本思想

父组件中给子组件绑定属性
子组件内部通过props选项接收数据

2. 子传父

基本思想

父组件中给子组件标签通过@绑定事件
子组件内部通过 emit 方法触发事件

小结

父传子

1. 父传子的过程中通过什么方式接收props？

defineProps( { 属性名：类型 } )

2. setup语法糖中如何使用父组件传过来的数据？

const props = defineProps( { 属性名：类型 } )

子传父

1. 子传父的过程中通过什么方式得到emit方法？

defineEmits( [‘事件名称’] )

组合式API - 模版引用

概念：通过 ref标识获取真实的 dom对象或者组件实例对象

1. 基本使用

实现步骤：

调用ref函数生成一个ref对象
通过ref标识绑定ref对象到标签

<script setup>
import { ref } from 'vue'
// 1. 调用ref函数得到ref对象
const h1Ref = ref(null)
</script>

<template>
  <!-- 2. 通过ref标识绑定ref对象 -->
  <h1 ref="h1Ref">我是dom标签h1</h1>
</template>

2. defineExpose

默认情况下在 <script setup>语法糖下组件内部的属性和方法是不开放给父组件访问的

可以通过defineExpose编译宏指定哪些属性和方法容许访问

说明：指定testMessage属性可以被访问到

案例

父组件

<script setup>
import { onMounted, ref } from 'vue'
import TestCom from './test-com.vue'

// 1. 调用ref函数 -> ref对象
const h1Ref = ref(null)
const comRef = ref(null)

// 组件挂载完毕之后才能获取
onMounted(() => {
  console.log(h1Ref.value)
  console.log(comRef.value)
})
</script>

<template>
  <!-- 2. 通过ref标识绑定ref对象 -->
  <h1 ref="h1Ref">我是dom标签h1</h1>
  <TestCom ref="comRef" />
</template>

子组件

<script setup>
import { ref } from 'vue'

const name = ref('test name')
const setName = () => {
  name.value = 'test new name'
}

// 向外暴露属性和方法，供父组件调用
defineExpose({
  name,
  setName
})
</script>

<template>
  <div>我是test组件</div>
</template>

小结

1. 获取模板引用的时机是什么？

组件挂载完毕

2. defineExpose编译宏的作用是什么？

显式暴露组件内部的属性和方法

组合式API - provide和inject

1. 作用和场景

顶层组件向任意的底层组件传递数据和方法，实现跨层组件通信

2. 跨层传递普通数据

实现步骤

顶层组件通过 provide 函数提供数据
底层组件通过 inject 函数提供数据

3. 跨层传递响应式数据

在调用provide函数时，第二个参数设置为ref对象

4. 跨层传递方法

顶层组件可以向底层组件传递方法，底层组件调用方法修改顶层组件的数据

案例

顶层组件

<script setup>
import { provide } from 'vue'
import RoomMsgItem from './room-msg-item.vue'

// 组件嵌套关系：RoomPage -> RoomMsgItem -> RoomMsgComment

// 1. 顶层组件提供普通数据
provide('data-key', 'this is room data')

// 2. 传递响应式数据
const count = ref(0)
provide('count-key', count)
setTimeout(() => {
  count.value = 100
}, 3000)

// 3. 传递方法
const setCount = () => {
  count.value++
}
provide('setCount-key', setCount)
</script>

<template>
  <div class="page">
    顶层组件
    <RoomMsgItem />
  </div>
</template>

<style scoped>
</style>

底层组件

<script setup>
import { inject } from 'vue'

// 接收普通数据
const roomData = inject('data-key')

// 接收响应式数据
const countData = inject('count-key')

// 接收方法
const setCount = inject('setCount-key')
</script>

<template>
  <div class="comment">
    底层组件
    <div>
      来自顶层组件中的数据为：{{ roomData }}
    </div>
    <div>
      来自顶层组件的响应式数据：{{ countData }}
    </div>
    <div>
      <button @click="setCount">修改顶层组件的数据count</button>
    </div>
  </div>
</template>

小结

1. provide和inject的作用是什么？跨层组件通信

2. 如何在传递的过程中保持数据响应式？第二个参数传递ref对象

3. 底层组件想要通知顶层组件做修改，如何做？传递方法，底层组件调用方法

4. 一颗组件树中只有一个顶层或底层组件吗？相对概念，存在多个顶层和底层的关系

综合案例

1. 项目地址

git clone  http://git.itcast.cn/heimaqianduan/vue3-basic-project.git

2. 项目说明

模版已经配置好了案例必须的安装包
案例用到的接口在 README.MD文件中
案例项目有俩个分支，main主分支为开发分支，complete分支为完成版分支供开发完参考

3.逻辑代码

app.vue

<script setup>
import axios from 'axios'
import Edit from './components/Edit.vue'
import { ref, onMounted } from 'vue'

// TODO: 列表渲染
const list = ref([])
const getList = async () => {
  const res = await axios.get('/list')
  list.value = res.data
}
onMounted(() => getList())
// TODO: 删除功能
const onDeleted = async (id) => {
  await axios.delete(`/del/${id}`)
  getList()
}

// TODO: 编辑功能
// 思路：打开弹框->回填数据->更新数据
// 1.打开弹框(获取子组件实例 调用方法或者修改属性)
// 2.回调数据(调用详情接口 / 当前行的静态数据)

const editRef = ref(null)
const onEdit = (row) => {
  console.log();
  editRef.value.open(row)
}

</script>

<template>
  <div class="app">
    <el-table :data="list">
      <el-table-column label="ID" prop="id"></el-table-column>
      <el-table-column label="姓名" prop="name" width="150"></el-table-column>
      <el-table-column label="籍贯" prop="place"></el-table-column>
      <el-table-column label="操作" width="150">
        <template #default="{ row }">
          <el-button type="primary" link @click="onEdit(row)">编辑</el-button>
          <el-button type="danger" link @click="onDeleted(row.id)">删除</el-button>
        </template>
      </el-table-column>
    </el-table>
  </div>
  <Edit ref="editRef" @on-update="getList" />
</template>

<style scoped>
.app {
  width: 980px;
  margin: 100px auto 0;
}
</style>

Edit.vue

<script setup>
// TODO: 编辑
import { ref } from 'vue'
import axios from 'axios'

// 弹框开关
const dialogVisible = ref(false)
const form = ref({ id: '', name: '', place: '' })

const open = (row) => {
  dialogVisible.value = true
  form.value.id = row.id
  form.value.name = row.name
  form.value.place = row.place
}
defineExpose({ open })

const emit = defineEmits(['on-update'])
const onUpdate = async () => {
  await axios.patch(`/edit/${form.value.id}`, {
    name: form.value.name,
    place: form.value.place
  })
  dialogVisible.value = false
  emit('on-update')
}

</script>

<template>
  <el-dialog v-model="dialogVisible" title="编辑" width="400px">
    <el-form label-width="50px">
      <el-form-item label="姓名">
        <el-input placeholder="请输入姓名" v-model="form.name" />
      </el-form-item>
      <el-form-item label="籍贯">
        <el-input placeholder="请输入籍贯" v-model="form.place" />
      </el-form-item>
    </el-form>
    <template #footer>
      <span class="dialog-footer">
        <el-button @click="dialogVisible = false">取消</el-button>
        <el-button type="primary" @click="onUpdate">确认</el-button>
      </span>
    </template>
  </el-dialog>
</template>

<style scoped>
.el-input {
  width: 290px;
}
</style>