小程序源码网站论坛原创软文

Vue3 的 setup 语法糖是通过 <script setup> 标签启用的特性，它是对 Composition API 的进一步封装，旨在简化组件的声明式写法，同时保留 Composition API 的逻辑组织能力。以下是其核心概念和原理分析：

---

一、<script setup> 是什么？

1. 语法糖本质
   它是 Vue3 编译器在编译阶段对组件逻辑的语法转换工具。开发者用更简洁的语法编写逻辑，最终会被编译成标准 setup() 函数的返回形式。

2. 主要特性

   • 自动暴露顶层变量（无需 return）
   • 直接使用 await（自动生成异步包装）
   • 组件/指令自动注册（无需 components 选项）
   • 支持 TypeScript 类型推导（如 defineProps）

---

二、语法糖的编译原理

以下是一个代码转换示例，展示 <script setup> 如何被编译为传统写法：

原始代码（语法糖）：

<script setup>
import { ref } from 'vue'
import MyComponent from './MyComponent.vue'const count = ref(0)
const increment = () => count.value++
</script>

编译后代码：

export default {setup() {const count = ref(0)const increment = () => count.value++// 自动返回所有顶层变量return {count,increment,MyComponent // 自动注册组件}},components: {MyComponent // 编译器自动处理组件注册}
}

---

三、关键技术实现

1. 编译阶段转换
   Vue 编译器（如 @vue/compiler-sfc）会在构建时：

   • 提取 <script setup> 中的顶层变量
   • 自动生成 return 语句暴露这些变量
   • 将 import 的组件转换为 components 选项

2. 响应式绑定
   ref 或 reactive 变量会被编译器识别，生成对应的 Proxy 响应式代码。

3. 宏函数处理
   如 defineProps、defineEmits 是编译时的特殊宏，编译器会将其转换为标准的 props/emits 声明：

   <script setup>
   const props = defineProps({ msg: String })
   const emit = defineEmits(['submit'])
   </script>
   

   编译为：

   export default {props: { msg: String },emits: ['submit'],setup(props, { emit }) {// ...}
   }
   

   需要注意的是，Vue从3.5版本开始，已经支持响应式解构Props，也就是当在同一个 script setup 块中的代码访问从 defineProps 解构出的变量时，Vue 的编译器会自动在前面添加 props.。

   const { foo } = defineProps(['foo'])watchEffect(() => {// 在 3.5 之前仅运行一次// 在 3.5+ 版本中会在 "foo" prop 改变时重新运行console.log(foo)})
   

   编译为：

   const props = defineProps(['foo'])watchEffect(() => {// `foo` 由编译器转换为 `props.foo`console.log(props.foo)})
   

---

四、优势与适用场景

特性	传统 setup 函数	<script setup>
代码量	需显式 return	自动暴露顶层变量
组件注册	需在 components 声明	自动注册导入的组件
异步逻辑	需手动包装异步上下文	直接使用 await
TypeScript 支持	需类型断言	自动推导 props/emit 类型

适用场景：适用于需要清晰逻辑组织的复杂组件，尤其是需要 TypeScript 强类型支持或大量 Composition API 复用的场景。

---

五、@vue/compiler-sfc核心解析

@vue/compiler-sfc是Vue官方的单文件（SFC）编译器，负责将.vue文件解析为标准的JavaScript模块，它的主要任务包括：

1. 分离<template>、<script>、<style> 三大块
2. 处理模版编译为渲染函数
3. 转换 <script setup> 语法糖
4. 处理 CSS 作用域（Scoped CSS）

关键功能实现

• 模板编译
  将 HTML-like 模板转换为 虚拟 DOM 渲染函数：

  <!-- 输入 -->
  <template><div @click="count++">{{ count }}</div>
  </template>
  

  // 输出渲染函数
  import { createElementVNode as _createElementVNode } from "vue"
  export function render(_ctx) {return _createElementVNode("div", { onClick: _ctx.increment }, _toDisplayString(_ctx.count))
  }
  

• <script setup> 转换
  将顶层变量自动注入 setup() 返回对象：

  <script setup>
  import { ref } from 'vue'
  const count = ref(0)
  </script>
  

  // 转换后
  export default {setup() {const count = ref(0)return { count } // 自动注入}
  }
  

• CSS 作用域处理
  为 Scoped CSS 添加唯一哈希属性：

  <style scoped>
  .box { color: red; }
  </style>
  

  .box[data-v-5f8d2c] { color: red; }
  

与其他工具协作

• 与 Vite：通过 @vitejs/plugin-vue 插件集成，实现开发时热更新
• 与 Webpack：通过 vue-loader 调用 @vue/compiler-sfc
• 与 TypeScript：通过 defineProps/defineEmits 实现类型推导

SFC在线演练场

访问Vue SFC Playground直接输入 Vue SFC 代码，右侧会实时显示编译后的 JavaScript 代码。

---

六、总结

通过编译时的智能转换，<script setup> 在保持逻辑组织能力的同时，大幅减少了样板代码，是 Vue3 开发的高效实践方案。

以上就是对 setup 语法糖的一点点介绍啦^-^