Vue 3 入门:组合式 API 与第一个组件
Vue 3 是目前最主流的前端框架之一,而组合式 API(Composition API)是它最值得先掌握的新写法。本文用一个计数器组件,带你走完从环境搭建到组件通信的完整入门路径。
一、为什么先学组合式 API
Vue 2 的选项式 API 把数据、方法、计算属性分散在 data、methods、computed 等不同选项里,一个功能相关的逻辑常常被拆到好几个地方。组合式 API 允许我们按功能把逻辑组织在一起:和计数器有关的状态、方法和监听都写在同一处,读起来更顺,也更容易抽成可复用的函数。配合 TypeScript 使用时,它的类型推导也更自然。
二、三分钟搭好开发环境
先确认本地安装了 Node.js 18 以上版本,然后用官方脚手架创建一个项目:
npm create vue@latest vue3-demo
cd vue3-demo
npm install
npm run dev
按提示一路回车即可,脚手架会帮你配好 Vite 等工具链。启动后打开终端给出的本地地址,看到欢迎页就说明环境就绪了。
三、setup 与 ref:组件的起点
Vue 3 推荐使用 <script setup> 语法糖,写在其中的顶层变量和函数可以直接在模板里使用,不用再写 return。响应式状态用 ref 创建:
import { ref } from 'vue'
const count = ref(0)
function add() {
count.value++
}
注意一个关键细节:在 <script> 里读写 ref 必须加 .value,而在模板里可以直接写 {{ count }},模板会自动解包。刚上手时十有八九会在这里踩一次坑,记住这条规则就能少走很多弯路。
四、第一个组件:计数器
新建 src/components/Counter.vue,把状态和模板写在一起:
<script setup>
import { ref } from 'vue'
const count = ref(0)
</script>
<template>
<button @click="count++">点了 {{ count }} 次</button>
</template>
然后在 App.vue 里引入并使用 <Counter />。点击按钮数字递增,你的第一个组件就跑起来了。这个例子虽小,却已经包含了状态、事件绑定和模板渲染这三件最核心的事。
五、组件之间怎么通信
父组件通过 props 把数据传给子组件,子组件通过 emit 把事件发回父组件。声明 props 用 defineProps,声明事件用 defineEmits,两者都是编译器宏,不需要 import:
const props = defineProps({ initial: { type: Number, default: 0 } })
const emit = defineEmits(['change'])
单向数据流是 Vue 的基本约定:props 只读,子组件不要直接修改它,需要变化时 emit 事件,让父组件去改。
六、计算属性与监听
派生状态用 computed,它自带缓存,只有依赖变化时才重新计算;副作用用 watch,适合监听某个值去发请求或写日志。能用 computed 表达的就别用 watch,代码会更简洁。
七、新手最容易踩的三个坑
第一,reactive 创建的对象不能解构,解构后会丢失响应性;第二,忘记给 v-for 加唯一的 key,列表更新会出现错乱;第三,在异步回调里直接给 ref 整体赋值而忘了 .value。
组合式 API 的学习曲线并不陡:先掌握 ref、computed、watch 和 props/emit,就能写出大部分日常组件。接下来可以试着把计数逻辑抽成一个 useCounter 函数,体会逻辑复用的乐趣,这也是组合式 API 真正的魅力所在。
- 点赞
- 收藏
- 关注作者
评论(0)