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 3 + TypeScript 项目中的 UserCard.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>预期结果
页面显示 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 文件时,可以先按“模板渲染什么、脚本提供什么、样式影响什么”三个问题阅读,再追踪编译后的关联。这样即使组件逐渐变大,也不容易把结构、逻辑和样式混成一团。