mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4
3835 words
10 minutes
Vue 3 入门:从第一个组件到待办清单
2026-10-21

假设要做一个待办清单:输入任务,点击添加,勾选完成,再显示剩余数量。

用原生 JavaScript 实现时,你会给按钮绑定事件、创建列表元素、修改文字,还要保证统计数字和列表始终一致。功能增加以后,维护这些页面更新逻辑会占用越来越多的精力。

Vue 可以帮助你管理这件事:用数据描述当前状态,用模板描述页面如何显示,用户操作时修改数据,Vue 负责把变化反映到页面。

这篇使用 Vue 3、JavaScript、组合式 API 和 <script setup>。组合式 API 可以先理解为一组用于组织状态和逻辑的函数;<script setup> 则让这些函数在组件里写起来更简洁。你只需要认识 HTML 标签、CSS 选择器,以及 JavaScript 的变量、函数、数组和对象。

我们会先运行一个按钮,再完成待办清单,最后把列表项拆成可复用组件。前面的代码标明了替换位置;读到完整示例时,可以直接复制运行。

一、创建第一个 Vue 项目#

1. 准备环境#

先安装满足 Vue 官方工具要求的 Node.js,并在终端执行:

node -v
npm -v

两条命令都应输出版本号。本文写作时,Vue 中文文档列出的 Node.js 要求为 ^22.18.0 || >=24.12.0;后续工具可能调整要求,创建项目时以官方快速上手中的说明为准。

Node.js 在这里用于运行开发工具;页面中的 Vue 代码主要在浏览器里运行。

2. 创建并启动#

在准备存放练习项目的目录打开终端,运行:

npm create vue@latest

这是 Vue 官方脚手架 create-vue 的创建命令。项目名填写 vue-todo,本次练习不启用 TypeScript、JSX、Router、Pinia 和测试等可选功能;如果出现额外的实验选项,也先不启用。提示内容会随工具版本变化,目标是创建一个最简单的 JavaScript 项目。

创建完成后运行:

cd vue-todo
npm install
npm run dev

打开终端打印的本地地址,应该能看到初始页面。端口被占用时地址可能变化,使用实际输出的地址即可。

这里 npm install 安装依赖,npm run dev 启动开发服务器。后面的操作都在新建的 vue-todo 项目中进行。

3. 先认识三个文件#

vue-todo/
├── index.html 浏览器加载的 HTML 入口
├── package.json 依赖与运行命令
└── src/
├── main.js 创建 Vue 应用,并挂载到页面
├── App.vue 根组件,接下来主要修改这里
└── components/ 存放拆出来的组件

初始项目可能还有图片、样式等文件,暂时不用逐个理解。在 src/main.js 中,应用启动的核心通常是:

import { createApp } from 'vue'
import App from './App.vue'
createApp(App).mount('#app')

createApp(App) 创建应用,mount('#app') 把它挂载到 index.html 中 id="app" 的元素上。保留脚手架生成的其他代码即可。

二、用一个按钮理解组件和响应式#

把 src/App.vue 的内容完整替换为:

<script setup>
import { ref } from 'vue'
const count = ref(0)
function increment() {
count.value++
}
</script>
<template>
<main>
<h1>我的第一个 Vue 页面</h1>
<p>已经点击 {{ count }} 次</p>
<button @click="increment">加一</button>
</main>
</template>
<style scoped>
main {
padding: 24px;
}
button {
cursor: pointer;
}
</style>

保存后,浏览器里的页面会更新。连续点击三次按钮,文字应该变成“已经点击 3 次”。

一个 .vue 文件把组件的逻辑、页面结构和样式放在一起,叫作单文件组件。可以先把组件理解为“一块有自己结构和行为的界面”,例如搜索框、商品卡片或整个待办页面。

区块负责什么本例中的内容
<script setup>状态和处理逻辑次数、点击后加一
<template>页面结构标题、文字、按钮
<style scoped>当前组件的样式留白、鼠标样式

scoped 会通过编译限制样式的作用范围,日常可以先按“为当前组件写样式”理解;脚手架里的全局样式仍可能影响页面外观。

这段代码最关键的是三处:

  • ref(0) 创建一个可被 Vue 跟踪的状态,初始值为 0。
  • {{ count }} 把状态作为文字显示在页面上。
  • @click="increment" 在点击时调用 increment 函数。

函数改变 count.value 后,Vue 会安排页面更新。你不需要再查找 <p> 元素并手动改它的文字。脚本中访问这个 ref 的值要写 .value;模板里直接使用这里的顶层 ref,Vue 会自动解包。 这一用法见响应式基础。

不要把状态写成下面这样,并期待它独立触发页面更新:

let count = 0
function increment() {
count++
}

普通变量的赋值没有接入 Vue 的响应式跟踪。页面中需要随操作变化的状态,先使用 ref 就足够了;它也能装对象和数组。

三、先认识模板里的常用写法#

Vue 模板在 HTML 上增加了一些表达数据和行为的语法。以 v- 开头的特殊属性叫作指令。

写法用途例子
{{ expression }}显示文字{{ remainingCount }}
:attribute根据表达式设置属性,是 v-bind 的简写:disabled="!newTitle.trim()"
@event监听事件,是 v-on 的简写@click="removeTodo(todo.id)"
v-model让表单输入和状态联动v-model="newTitle"
v-if / v-else按条件创建或移除内容没有任务时显示提示
v-for根据数组生成列表v-for="todo in todos"

注意文字插值和属性绑定的位置不同。显示文字用 {{ title }},设置属性要写 :title="title",不能写成 title="{{ title }}"。

表单中,v-model="newTitle" 让输入框和 newTitle 保持联动:用户输入时状态更新,代码清空状态时输入框也清空。普通文本输入默认在输入事件时同步,但中文输入法拼字期间不会逐字提交中间状态。具体规则见表单输入绑定。

接下来把这些写法放到一个完整页面里使用。

四、完成一个能运行的待办清单#

再次完整替换 src/App.vue,使用下面这份代码:

<script setup>
import { computed, ref } from 'vue'
const newTitle = ref('')
const todos = ref([
{ id: 1, title: '运行第一个 Vue 页面', done: true },
{ id: 2, title: '完成待办清单', done: false },
])
let nextId = 3
const remainingCount = computed(() => {
return todos.value.filter(todo => !todo.done).length
})
function addTodo() {
const title = newTitle.value.trim()
if (!title) return
todos.value.push({ id: nextId++, title, done: false })
newTitle.value = ''
}
function toggleTodo(id) {
const todo = todos.value.find(item => item.id === id)
if (todo) todo.done = !todo.done
}
function removeTodo(id) {
todos.value = todos.value.filter(todo => todo.id !== id)
}
</script>
<template>
<main class="todo-app">
<h1>我的待办清单</h1>
<p>共 {{ todos.length }} 项,还有 {{ remainingCount }} 项未完成</p>
<form @submit.prevent="addTodo">
<label for="new-title">新任务</label>
<input
id="new-title"
v-model="newTitle"
placeholder="例如:学习组件通信"
/>
<button type="submit" :disabled="!newTitle.trim()">添加</button>
</form>
<p v-if="todos.length === 0">还没有任务,先添加一项吧。</p>
<ul v-else>
<li v-for="todo in todos" :key="todo.id">
<label>
<input
type="checkbox"
:checked="todo.done"
@change="toggleTodo(todo.id)"
/>
<span :class="{ done: todo.done }">{{ todo.title }}</span>
</label>
<button type="button" @click="removeTodo(todo.id)">删除</button>
</li>
</ul>
</main>
</template>
<style scoped>
.todo-app {
width: min(100%, 560px);
margin: 32px auto;
padding: 20px;
box-sizing: border-box;
}
form, li, li label {
display: flex;
align-items: center;
gap: 12px;
}
form {
flex-wrap: wrap;
}
input:not([type='checkbox']) {
flex: 1;
min-width: 0;
padding: 8px;
}
ul {
padding: 0;
list-style: none;
}
li {
justify-content: space-between;
padding: 10px 0;
}
li label {
min-width: 0;
overflow-wrap: anywhere;
}
button {
padding: 6px 12px;
cursor: pointer;
flex-shrink: 0;
}
button:disabled {
cursor: not-allowed;
}
.done {
color: #767676;
text-decoration: line-through;
}
</style>

保存后,按顺序检查下面这些操作:

操作预期结果
首次打开有两项任务,显示一项未完成
输入“学习组件通信”,点击添加出现第三项,未完成数变成二,输入框清空
输入任务后按回车同样能够添加,页面不刷新
不输入内容,或者只输入空格添加按钮禁用,任务数不变
勾选一个未完成任务文字出现删除线,未完成数减一
删除所有任务显示“还没有任务”提示

本例数据只保存在当前页面的内存中,刷新后会恢复初始两项任务。

五、顺着一次“添加任务”读懂代码#

用户输入“学习组件通信”后,v-model 把内容同步到 newTitle。点击添加或在输入框按回车,都触发表单的 submit 事件。

@submit.prevent="addTodo" 做两件事:调用 addTodo,并通过 .prevent 阻止表单提交的默认页面导航行为。这样就能留在当前页面更新清单。

addTodo 先去掉首尾空白,再检查是否为空。按钮禁用提供界面反馈,函数里的检查则保证逻辑本身也拒绝空任务。

通过检查以后,新对象被加入 todos.value。Vue 跟踪到了数组的变化,v-for 就会显示新的列表项。最后把 newTitle.value 设为空字符串,输入框也随之清空。

这里 nextId 使用普通变量,因为它只是分配标识的内部计数器,不需要靠它的变化更新页面。页面真正展示的是加入数组之后的任务对象。

为什么列表需要 key#

v-for="todo in todos" 为每个任务生成一项;:key="todo.id" 给每项提供稳定身份,让 Vue 能在增删和排序时识别它。

对于这种会删除、以后可能排序的任务列表,使用任务自己的唯一 ID。数组下标会随位置改变,任务标题也可能重复,都不适合充当这里的身份标识。相关机制见列表渲染。

本例的自增 ID 只适用于这份内存数据;以后接入服务器时,应使用服务器返回的任务 ID。

条件和样式怎样随数据变化#

v-if 在没有任务时显示提示;v-else 与它相邻,在有任务时显示列表。若只是需要频繁切换元素的可见性,还可以学习 v-show:它保留元素,通过 CSS 的 display 切换显示。

:class="{ done: todo.done }" 表示:当任务完成时,给元素加上 done 类,命中删除线样式。勾选后修改的是任务对象,复选框、文字样式和统计数都从这份状态得出。

六、用 computed 计算剩余数量#

待办清单里没有单独维护一个“剩余数量”变量,而是这样定义:

const remainingCount = computed(() => {
return todos.value.filter(todo => !todo.done).length
})

computed 叫作计算属性,适合表达“根据现有状态算出的结果”。这里先筛选未完成任务,再取数量。

如果手动维护一个数字,添加、删除、勾选任务时都要记得更新它;漏掉一个分支,统计就会错误。使用计算属性以后,这个结果由任务列表推导,变化集中在一份数据上。

计算属性会基于读取到的响应式依赖缓存结果,相关依赖变化后重新求值。计算函数应专心返回结果,不要在里面发请求或反过来修改任务。详见计算属性。

和 ref 类似,脚本里读取结果用 remainingCount.value,这里的模板直接写 remainingCount。

七、把列表项拆成组件#

当一个页面越来越长,可以把职责清楚的部分拆开。现在让 App.vue 管理任务数据,让 TodoItem.vue 负责展示单项任务、通知用户操作。

1. 新建 TodoItem.vue#

在 src/components/TodoItem.vue 中写入:

<script setup>
defineProps({
todo: { type: Object, required: true },
})
const emit = defineEmits(['toggle', 'remove'])
</script>
<template>
<li>
<label>
<input
type="checkbox"
:checked="todo.done"
@change="emit('toggle', todo.id)"
/>
<span :class="{ done: todo.done }">{{ todo.title }}</span>
</label>
<button type="button" @click="emit('remove', todo.id)">删除</button>
</li>
</template>
<style scoped>
li, label {
display: flex;
align-items: center;
gap: 12px;
}
li {
justify-content: space-between;
padding: 10px 0;
}
label {
min-width: 0;
overflow-wrap: anywhere;
}
button {
padding: 6px 12px;
flex-shrink: 0;
cursor: pointer;
}
.done {
color: #767676;
text-decoration: line-through;
}
</style>

defineProps 声明父组件传入的数据,defineEmits 声明向父组件发出的事件。它们是 <script setup> 中的编译器宏,不需要从 vue 导入。

2. 修改 App.vue#

在 App.vue 的 <script setup> 中增加导入,其他状态和函数保持原样:

import TodoItem from './components/TodoItem.vue'

然后把原来的整个 <ul v-else>...</ul> 替换成:

<ul v-else>
<TodoItem
v-for="todo in todos"
:key="todo.id"
:todo="todo"
@toggle="toggleTodo"
@remove="removeTodo"
/>
</ul>

此时列表项的布局和 .done 样式已经移入 TodoItem.vue,可以从父组件样式里删除只针对列表项的规则;保留表单、容器、ul 和添加按钮的样式。

保存后重复添加、勾选和删除,结果应该与拆分前一致。

3. 数据和事件各走哪个方向#

父组件通过 :todo="todo" 把任务交给子组件,这类输入叫作 prop。子组件通过 emit('remove', todo.id) 把删除意图和任务 ID 告诉父组件。父组件的 @remove="removeTodo" 收到 ID 后执行原来的删除函数。

可以按这条路径读代码:

App 持有 todos → 通过 prop 交给 TodoItem 展示
用户点击删除 → TodoItem 发出 remove(id) → App 修改 todos

数据由谁维护,谁就负责修改它。子组件避免直接改传入的任务对象,这样后续排查状态变化更容易。对象 prop 的嵌套属性在技术上仍能被修改,并不会因为传入就变成深层只读;这里采用事件通知是为了明确责任。详见官方的 Props 和组件事件说明。

八、watch 和生命周期先学到什么程度#

完成上面的页面,还不需要 watch 或生命周期钩子。等到要在状态变化后执行额外动作,或者在组件显示时连接外部资源,再引入它们。

watch:变化之后做一件事#

例如,想在学习时观察未完成数怎样变化,可以把 watch 加入现有的 vue 导入,再在 remainingCount 定义之后写:

watch(remainingCount, (newCount, oldCount) => {
console.log(`未完成数:${oldCount} → ${newCount}`)
})

勾选一项任务后,浏览器开发者工具的控制台会打印新旧数量。watch 默认不会立即执行这个回调,后续观察到值变化才执行。

这里监听的是计算属性本身,不要传 remainingCount.value:后者只是当时取出的数字。需要监听某个对象属性时,通常传入一个读取它的函数。更多规则见侦听器。

选择时先看目的:需要一个派生结果,用 computed;需要在变化后执行日志、请求等额外动作,再考虑 watch。

生命周期:组件经历了哪些阶段#

组件会经历创建、挂载到页面、更新和卸载等阶段。常见的 onMounted 用于组件挂载后执行操作,onUnmounted 用于卸载时清理定时器、监听器等资源。

例如,在已有 <script setup> 中导入 onMounted 后,可以注册一个挂载回调:

onMounted(() => {
console.log('待办页面已经挂载')
})

把钩子注册写在 <script setup> 的顶层。它会在该组件实例挂载时执行,而不是每次点击按钮都执行。正式用法可以继续阅读生命周期钩子。

九、遇到问题先检查这些地方#

现象优先检查
点击后文字不变页面状态是否用了 ref,脚本中是否修改了 .value
页面显示 [object Object]是否把整个任务对象插入了文本,应显示 todo.title
属性里出现字面量表达式动态属性前是否加了 :,例如 :disabled
回车后页面刷新表单是否使用 @submit.prevent
列表出现 key 警告或状态错位每项是否使用唯一、稳定的 todo.id
拆分后找不到组件导入路径、文件名大小写、模板标签是否一致
刷新后任务恢复初始值当前示例只使用内存数据,需要另做持久化

如果页面空白,先看终端的编译错误,再看浏览器控制台。优先解决第一条明确错误,后面的报错可能只是连锁结果。

十、接下来练什么#

先独立增加“只看未完成”功能:新增一个布尔状态,通过复选框控制;用 computed 返回要展示的任务;让 v-for 遍历这个结果。不要直接把原数组过滤后覆盖,否则已完成任务会被删掉。

验收时,先把一项任务勾选完成,再打开过滤,它应该隐藏;关闭过滤后应该重新出现,原来的完成状态仍然保留。

完成这个练习以后,再尝试编辑任务名称、本地保存和后端接口。需要多个页面时学习 Vue Router,需要跨多个组件共享业务状态时再学习 Pinia。它们分别解决不同规模的问题,可以随着实际需求逐步引入。

当前示例已经覆盖一个小页面的状态、交互和组件边界;它没有实现刷新后保存、多用户同步和后端校验。接入真实服务时,还需要处理加载状态、请求失败,以及服务器返回的数据怎样更新到页面。

Share

If this article helped you, please share it with others!

Vue 3 入门:从第一个组件到待办清单
https://mizuki.mysqil.com/posts/vue-beginner-guide/
Author
梦幻晨风
Published at
2026-10-21
License
CC BY-NC-SA 4.0

Some information may be outdated

Table of Contents