Vue 3 入门:组合式 API 与第一个组件

举报
yd_231037148 发表于 2026/11/16 06:07:23 2026/11/16
【摘要】 Vue 3 是目前最主流的前端框架之一,而组合式 API(Composition 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 真正的魅力所在。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。