Vue 2 中 SSR 的原理、实现方法及优势介绍

2025/3/9
本文详细介绍了 SSR(Server-Side Rendering,服务端渲染)技术,阐述其解决的 SEO、首屏加载性能、低性能设备支持等问题,重点讲解在 Vue 2 中实现 SSR 的具体步骤及代码示例,最后总结 SSR 的作用及在 Vue 2 中的实现方式。
Vue 2 中 SSR 实现流程示意图,SSR 解决 SEO 问题的对比图,首屏加载性能对比图,低性能设备支持对比图,Vue 2 中 SSR 相关代码片段截图

SSR(Server-Side Rendering,服务端渲染)是一种将页面渲染过程从客户端转移到服务器端的技术。它主要解决了以下问题:

  1. SEO(搜索引擎优化):传统的单页应用(SPA)在客户端渲染时,搜索引擎爬虫可能无法正确解析和索引页面内容,而 SSR 可以在服务器端生成完整的 HTML,便于搜索引擎抓取。

  2. 首屏加载性能:SPA 在首次加载时需要下载大量的 JavaScript 文件,并在客户端执行渲染,这可能导致较长的白屏时间。SSR 在服务器端生成完整的 HTML,用户可以直接看到渲染好的内容,提升首屏加载速度。

  3. 低性能设备支持:对于一些低性能设备(如旧版手机或平板),客户端渲染可能会导致卡顿或无法正常使用。SSR 可以在服务器端完成渲染,减轻客户端的负担。

SSR 的实现方法

在 Vue 2 中,可以通过以下步骤实现 SSR:

  1. 安装依赖
    首先需要安装 vue-server-rendererexpress(或其他 Node.js 服务器框架):

    npm install vue-server-renderer express
    
  2. 创建 Vue 实例
    在服务器端创建一个 Vue 实例,并导出供渲染使用:

    // app.js
    import Vue from 'vue';
    import App from './App.vue';
    
    export function createApp() {
      const app = new Vue({
        render: h => h(App)
      });
      return { app };
    }
    
  3. 创建服务器
    使用 express 创建一个服务器,并在请求时渲染 Vue 实例:

    // server.js
    const express = require('express');
    const { createBundleRenderer } = require('vue-server-renderer');
    const fs = require('fs');
    const path = require('path');
    
    const server = express();
    
    const template = fs.readFileSync(path.resolve(__dirname, './index.template.html'), 'utf-8');
    const serverBundle = require('./dist/vue-ssr-server-bundle.json');
    const clientManifest = require('./dist/vue-ssr-client-manifest.json');
    
    const renderer = createBundleRenderer(serverBundle, {
      template,
      clientManifest
    });
    
    server.use('/dist', express.static(path.resolve(__dirname, './dist')));
    
    server.get('*', (req, res) => {
      const context = { url: req.url };
    
      renderer.renderToString(context, (err, html) => {
        if (err) {
          if (err.code === 404) {
            res.status(404).end('Page not found');
          } else {
            res.status(500).end('Internal Server Error');
          }
        } else {
          res.end(html);
        }
      });
    });
    
    server.listen(8080, () => {
      console.log('Server is running on port 8080');
    });
    
  4. 构建配置
    使用 Webpack 分别构建客户端和服务端的入口文件:

    // webpack.client.config.js
    const { VueLoaderPlugin } = require('vue-loader');
    const HtmlWebpackPlugin = require('html-webpack-plugin');
    
    module.exports = {
      entry: './src/entry-client.js',
      output: {
        filename: '[name].js',
        path: path.resolve(__dirname, './dist')
      },
      module: {
        rules: [
          {
            test: /\.vue$/,
            loader: 'vue-loader'
          }
        ]
      },
      plugins: [
        new VueLoaderPlugin(),
        new HtmlWebpackPlugin({
          template: './index.template.html'
        })
      ]
    };
    
    // webpack.server.config.js
    const { VueLoaderPlugin } = require('vue-loader');
    
    module.exports = {
      entry: './src/entry-server.js',
      target: 'node',
      output: {
        filename: 'server-bundle.js',
        libraryTarget: 'commonjs2'
      },
      module: {
        rules: [
          {
            test: /\.vue$/,
            loader: 'vue-loader'
          }
        ]
      },
      plugins: [
        new VueLoaderPlugin()
      ]
    };
    
  5. 客户端激活
    在客户端入口文件中,使用 hydrate 方法激活 Vue 实例:

    // entry-client.js
    import { createApp } from './app';
    
    const { app } = createApp();
    
    app.$mount('#app');
    
  6. 服务端入口
    在服务端入口文件中,导出 Vue 实例:

    // entry-server.js
    import { createApp } from './app';
    
    export default context => {
      const { app } = createApp();
      return app;
    };
    

总结

SSR 通过将页面渲染过程从客户端转移到服务器端,解决了 SEO、首屏加载性能和低性能设备支持等问题。在 Vue 2 中,可以通过 vue-server-renderer 和 Webpack 实现 SSR,并结合 express 或其他服务器框架提供服务。

标签:Vue
上次更新:

相关文章

Node-Cache 完全指南 | Node.js 内存缓存模块使用教程

本文详细介绍了 Node-Cache 模块,这是一个简单高效的 Node.js 内存缓存解决方案,包括安装方法、基本使用、主要功能、高级特性、配置选项以及实际应用场景。

·前端开发

npx完全指南:前端开发必备工具详解 | 20年架构师深度解析

本文由20年前端架构师深入解析npx工具,涵盖其核心功能、优势、高级用法、最佳实践及与npm/yarn的区别比较,帮助开发者掌握这一现代前端开发利器。

·前端开发

Astro 静态站点生成器:构建高性能网站的最佳选择

Astro 是一个专注于构建快速、轻量级网站的静态站点生成器,支持多种前端框架,采用岛屿架构减少 JavaScript 加载,提升性能。

·前端开发

Weex 跨平台移动开发框架:核心特性与使用指南

Weex 是由阿里巴巴开源的跨平台移动开发框架,支持使用 Vue.js 或 Rax 构建高性能的 iOS、Android 和 Web 应用。本文详细解析了 Weex 的核心特性、架构、工作流程、组件和模块、开发工具、优缺点、应用场景及未来发展。

·前端开发

ECharts 与 DataV 数据可视化工具对比分析 | 选择指南

本文详细对比了 ECharts 和 DataV 两个常用的数据可视化工具,包括它们的设计目标、优缺点、使用场景和技术栈,帮助读者根据具体需求选择合适的工具。

·前端开发

前端部署后通知用户刷新页面的常见方案 | 单页应用更新提示

本文介绍了在前端部署后通知用户刷新页面的几种常见方案,包括WebSocket实时通知、轮询检查版本、Service Worker版本控制、版本号对比、自动刷新、使用框架内置功能以及第三方库。每种方案的优缺点和示例代码均有详细说明。

·前端开发

file-saver:前端文件下载的 JavaScript 库使用指南

file-saver 是一个用于在浏览器端保存文件的 JavaScript 库,支持生成和下载多种文件格式,如文本、JSON、CSV、图片、PDF 等。本文详细介绍其安装、基本用法、兼容性及与其他工具(如 jszip)的结合使用。

·前端开发

MSW(Mock Service Worker):API 模拟工具的核心优势与使用指南

MSW(Mock Service Worker)是一个用于浏览器和 Node.js 的 API 模拟工具,通过 Service Worker 拦截网络请求,支持 REST 和 GraphQL,适用于开发、测试和调试场景。本文详细介绍 MSW 的核心优势、快速上手步骤、高级用法、适用场景及与其他 Mock 工具的对比。

·前端开发

Preact:轻量级 JavaScript 库,React 的高性能替代方案

Preact 是一个轻量级的 JavaScript 库,提供与 React 相似的 API 和开发体验,但体积更小(约 3-4KB,gzip 后)。它专注于高性能和低资源消耗,特别适合对性能敏感或需要快速加载的 Web 应用。

·前端开发

WASI标准与WebAssembly跨平台生态的未来趋势分析 | 技术深度解析

本文深入探讨了WASI(WebAssembly System Interface)标准的背景、意义及其对WebAssembly跨平台生态的影响。文章分析了WASI在服务器端应用、边缘计算和IoT设备中的应用,以及技术栈和工具链的演进,最后展望了WASI对未来前端开发的影响和最佳实践建议。

·前端开发