SFC 语法规范

*.vue文件是使用类 HTML 语法来描述 Vue 组件的一种自定义文件格式。每一个*.vue文件都由三种类型的顶层语法块所组成：<template>、<script>、<style>以及可选的附加自定义块：

<template>
  <div class="example">{{ msg }}</div>
</template>

<script>
export default {
  data() {
    return {
      msg: 'Hello world!'
    }
  }
}
</script>

<style>
.example {
  color: red;
}
</style>

<custom1>
  这里可以是，例如：组件的文档
</custom1>

语言块

<template>

每个*.vue文件最多可同时包含一个顶层<template>块。
其中的内容会被提取出来并传递给@vue/compiler-dom，预编译为 JavaScript 的渲染函数，并附属到导出的组件上作为其render选项。

<script>

每一个*.vue文件，最多可同时包含一个<script>块(不包括<script setup>)。
该脚本将作为 ES Module 来执行。
其默认导出的内容应该是 Vue 组件选项对象，它要么是一个普通的对象，要么是defineComponent的返回值。

<script setup>

每个*.vue文件，最多可同时包含一个<script setup>块(不包括常规的<script>)
该脚本会被预处理并作为组件的setup()函数使用，也就是说它会在每个组件实例中执行。<script setup>的顶层绑定会自动暴露给模板。更多详情请查看<script setup>文档。

<style>

一个*.vue文件可以包含多个<style>标签。
<style>标签可以通过scoped或module attribute(更多详情请查看 SFC 样式特性)将样式封装在当前组件内。多个不同封装模式的<style>标签可以在同一个组件中混用。

自定义块

为了满足任何项目特定的需求，*.vue文件中还可以包含额外的自定义块，例如<docs>块。自定义块的一些真实场景的案例包括：

Gridsome:<page-query>
vite-plugin-vue-gql:<gql>
vue-i18n:<i18n>

对 Custom Block 的处理依赖于工具——如果你想要构建自己的自定义块集成。

自动 name 推断

SFC 在下列情况会依据它的文件名来自动推断组件名称：

开发环境警告格式化
DevTools 检查
递归的自引用。例如：名为FooBar的文件可以在模板中用<FooBar/>引用它自己。这种方式比明确注册或引入的组件的优先级要低。

预处理

块可以使用lang attribute 声明预处理语言。最常见的场景就是在<script>块中使用 TypeScript：

<script lang="ts">
  // 使用 TypeScript
</script>

lang 可以用于任何块——例如可以在<script>中使用 Sass 以及在<template>中使用 Pug：

<template lang="pug">
p {{ msg }}
</template>

<style lang="scss">
  $primary-color: #333;
  body {
    color: $primary-color;
  }
</style>

注意，基于不同的工具链，预处理器的集成方式有所不同。查看相关文档以获取示例：

src 引入

如果你倾向于将*.vue组件拆分为多个文件，可以使用src attribute 来引入外部的文件作为语言块：

<template src="./template"></template>
<style src="./style.css"></style>
<script src="./script.js"></script>

注意src引入所需遵循的路径解析规则与webpack模块请求一致，即：

相对路径需要以./开头。
你可以从npm依赖中引入资源：

<!-- 从已安装的 "todomvc-app-css" npm 包中引入文件 -->
<style src="todomvc-app-css/index.css">

src 引入也能用于自定义块，例如：

<unit-test src="./unit-test.js">
</unit-test>

注释

在每个块中，注释应该使用相应语言(HTML, CSS, JavaScript, Pug,等等)的语法。对于顶层的注释而言，使用 HTML 注释语法：

<!--这里是注释内容-->