什么是 Vapor

定义: Vue 3.6 新增的编译/渲染模式，不再构建/对比虚拟 DOM，而是将模板编译为“直达 DOM 的更新代码”，以更低内存与更快更新获得接近 Solid/Svelte 的性能。
特点
更快: 跳过 VDOM 创建与 diff，直接按依赖精准更新。
更小: 可移除大部分 VDOM 运行时代码，基础体积显著下降。
渐进启用: 同一应用内可对性能敏感子树按需开启，维持现有 API 心智（模板与 <script setup> 基本不变）。

适用与不适用

适用
性能关键页面/模块（列表、密集交互、落地页）
新项目希望默认更瘦更快
旧项目对热点组件/子树做增量迁移
暂不适用/注意
依赖 Options API 的组件（当前主要支持 <script setup>）
对 SSR + Hydration、<Transition>、<KeepAlive>、<Teleport>、Suspense 等特性有强依赖的场景（部分仍在完善）
深度混用“复杂 vDOM UI 库”的子树需充分测试

快速开始

新项目

初始化项目：

npm create vite@latest my-app -- --template vue
cd my-app
npm i

组件内启用 Vapor：在 SFC 使用 <script setup vapor>。
应用级启用（如当前版本提供）：使用 createVaporApp 启动，进一步减小体积并获得最佳启动性能。

src/main.js：

import { createVaporApp } from "vue/vapor";
import App from "./App.vue";createVaporApp(App).mount("#app");

src/App.vue：

<script setup vapor>
import { ref } from "vue";
const count = ref(0);
</script><template><button @click="count++">Count: {{ count }}</button>
</template>

旧项目增量启用

升级到 Vue 3.6+。
从性能热点组件开始，把对应 SFC 的 <script setup> 增加 vapor。
与第三方 vDOM 组件/库混用时，优先在“页面/大组件边界”切分，减少跨边界频繁更新。

现有 Vue 项目中混合使用配置

import { createApp, vaporInteropPlugin } from "vue";
import App from "./App.vue";
import router from "./router";createApp(App).use(vaporInteropPlugin).use(router).mount("#app");

组件级启用方式

在 SFC 使用 <script setup vapor>。
某些通道/历史实现也支持文件名后缀（如 Comp.vapor.vue）来显式标识 Vapor 编译；以所用版本发布说明为准。

应用级启用方式

使用 createVaporApp 启动应用，可剔除 vDOM 运行时代码，获得最小体积与最佳启动性能：

import { createVaporApp } from "vue/vapor";
import App from "./App.vue";
createVaporApp(App).mount("#app");

也可仅在组件级启用 Vapor，与 vDOM 同树共存，按需推进。

常用示例

1) 计数器

<script setup vapor>
import { ref } from "vue";
const count = ref(0);
</script><template><button @click="count++">Count: {{ count }}</button>
</template>

2) 条件/事件/表单

<script setup vapor>
import { ref } from "vue";
const show = ref(true);
const name = ref("");
const greet = () => alert(`Hi, ${name.value || "Vue"}`);
</script><template><label><input v-model="name" placeholder="Your name" /></label><button @click="greet">Greet</button><p v-if="show">Visible</p><button @click="show = !show">Toggle</button>
</template>

3) 列表与键控

<script setup vapor>
import { ref } from "vue";
const items = ref([1, 2, 3]);
const add = () => items.value.push(items.value.length + 1);
const removeFirst = () => items.value.shift();
</script><template><ul><li v-for="n in items" :key="n">Item {{ n }}</li></ul><button @click="add">Add</button><button @click="removeFirst">Remove first</button>
</template>

4) 自定义指令

值以“getter 形式”传入，返回可选“卸载清理函数”。

MyDirective.ts：

import { watchEffect } from "vue";
export const MyDirective = (el: HTMLElement, valueGetter: () => string) => {const stop = watchEffect(() => {el.textContent = valueGetter();});return () => stop();
};

使用：

<script setup vapor>
import { ref } from "vue";
import { MyDirective } from "./MyDirective";
const msg = ref("Hello");
</script><template><div v-my-directive="() => msg">Will mirror: {{ msg }}</div>
</template><script lang="ts">
export default {directives: { MyDirective },
};
</script>

与 vDOM 组件互操作

混用策略
Vapor 组件可以作为 vDOM 应用的子树引入，反之亦然。
建议在页面/大组件边界做切分，减少跨边界频繁更新。
第三方 UI 库
大多数以 props/事件/插槽为主的组件可直接工作。
复杂交互与依赖 vDOM 特性的组件需实测。
预览通道可能提供“互操作插件”（如 vaporInteropPlugin）以简化混用；以当前版本发布说明为准。

调试与验证

组件是否以 Vapor 方式运行：

import { getCurrentInstance } from "vue";
// @ts-expect-error: 非公开标记
const isVapor = !!getCurrentInstance()?.vapor;

性能观测：使用 Performance 面板、内存快照与自定义基准，关注首次渲染时间、内存峰值与交互时的长任务切片。

已知限制与注意事项

API 支持面
主要支持 Composition API + <script setup>；Options API 暂不推荐。
<Transition>、<KeepAlive>、<Teleport>、Suspense> 等在部分版本/场景下尚不完全等价（以发布说明为准）。
SSR/Hydration
目标是兼容既有 SSR 输出的水合；在复杂场景中请回归 vDOM 或充分测试。
指令
按 Vapor 新签名改造（值为 getter，支持返回清理函数）；旧式指令可借助 codemod 迁移（若提供）。
类型
TypeScript 可用；运行时类型可能包含 VaporComponent 等标注（随版本演进）。