Vue / 系统课时

单文件组件结构

单文件组件结构

Vue 单文件组件把结构、逻辑和样式放在同一个 .vue 文件中,但三者并不是简单拼接:它们会由编译器分别处理,再组合成浏览器可执行的组件。本课用一个最小示例看清 template、script setup、style 的职责与编译关系。

学习目标

  • 说清 template、script setup、style 各自负责什么。
  • 理解 <script setup> 中的变量为什么能直接在模板使用。
  • 能写出结构清晰、可编译的 Vue 3 + TypeScript 单文件组件。

三个区块各做什么

<template> 描述组件最终要渲染的界面结构。模板中的插值、属性绑定和事件绑定会在构建阶段编译成渲染函数,而不是以模板字符串原样交给浏览器执行。

<script setup lang="ts"> 承载组件状态、计算逻辑、事件处理和类型声明。<script setup> 是编译期语法,其中顶层声明会自动暴露给当前模板,因此无需再写 setup() 并手工 return。

<style> 负责当前组件使用的 CSS。加入 scoped 后,编译器会给当前组件的元素和选择器附加作用域标记,让样式主要限制在当前组件范围内。

Vue 单文件组件三个区块到编译产物的关系

写一个最小单文件组件

片段示例:以下内容应保存为 Vue 3 + TypeScript 项目中的 UserCard.vue,并由父组件正常引入后运行。

vue
<script setup lang="ts">
const user = {
  name: 'Ada Lovelace',
  role: '前端工程师'
}

function follow(): void {
  console.log(`follow ${user.name}`)
}
</script>

<template>
  <article class="card">
    <h2>{{ user.name }}</h2>
    <p>{{ user.role }}</p>
    <button type="button" @click="follow">关注</button>
  </article>
</template>

<style scoped>
.card {
  padding: 16px;
  border: 1px solid #ddd;
}

button {
  cursor: pointer;
}
</style>

预期结果

text
页面显示 Ada Lovelace、前端工程师和“关注”按钮;点击按钮后,浏览器控制台输出:
follow Ada Lovelace

这里的 user 和 follow 都是 <script setup> 顶层声明,所以模板可以直接访问。模板并不会读取任意脚本局部变量;只有处于组件编译上下文中的绑定才会参与模板生成。

编译时如何串起来

编译器首先解析 .vue 文件中的不同区块。模板被转换成渲染函数,<script setup> 被转换成组件的 setup 逻辑,样式则进入 CSS 处理链。随后这些结果被打包工具组合,最终交给浏览器执行。

scoped 也不是 Shadow DOM。它通常通过给当前组件生成稳定的作用域属性,并改写 CSS 选择器来限制匹配范围,因此仍然属于普通 CSS 机制。需要真正的样式隔离能力时,要区分它与 Web Components 的 Shadow DOM。

组织组件时的边界

一个单文件组件最好保持职责单一:模板负责表达 UI,脚本负责状态与行为,样式负责视觉表现。不要把可复用业务逻辑大量堆进 <script setup>;跨组件复用的状态逻辑更适合抽成 composable,跨页面共享的数据再考虑状态管理。

当你看到一个 .vue 文件时,可以先按“模板渲染什么、脚本提供什么、样式影响什么”三个问题阅读,再追踪编译后的关联。这样即使组件逐渐变大,也不容易把结构、逻辑和样式混成一团。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

单文件组件结构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通