createSSRApp() 创建 SSR 应用实例
最后更新：2026-10-22
createSSRApp() 创建 SSR 应用实例
createSSRApp() 与 createApp 相同，但采用注水（hydration）方式接管服务端渲染的 HTML。
| 分组 | 全局 API |
|---|---|
| 类型 | API |
| 作用域 | 全局 |
| Vue 版本 | 3.0+ |
| SSR 支持 | 支持 |
📝 语法
const app = createSSRApp(App)
app.mount("#app") // 注水，而非重建⚙️ 参数
| rootComponent, rootProps? | 与 createApp 相同（根组件 + 可选 props） |
|---|
返回值：应用实例
▶ 示例
修改下面的代码，在预览区实时查看效果：
输出：
控制台输出 createSSRApp 已创建；真实 SSR 项目里页面内容由服务端输出后被接管。💡 要点
ℹ️ 说明 注水要求服务端与客户端渲染结果一致，否则会出现不匹配警告。
⚠️ 注意 随机值/当前时间等不一致数据会造成注水失败，需在服务端与客户端保持同源。
💡 提示 普通 SPA 用 createApp；只有 SSR/SSG 项目才用本函数。
🏷️ 相关全局 API
💡 相关案例
更多案例即将上线。
📚 相关教程
❓ 常见问题
Q 和 createApp 的差别？
A 渲染策略不同：createApp 清空重建，createSSRApp 复用服务端 DOM。
Q 用错会怎样？
A SSR 页面上用 createApp 会闪一下并丢弃服务端 HTML（首屏白屏感）。
Q SPA 需要它吗？
A 不需要。
