Vue 服务端渲染原理及入门

2024-12-03 05:32

什么是 SSR ？

现代化的前端项目，大部分都是单页应用程序，也就是我们说的 SPA ，整个应用只有一个页面，通过组件的方式，展示不同的页面内容，所有的数据通过请求服务器获取后，在进行客户端的拼装和展示；这就是目前前端框架的默认渲染逻辑，我们称为：客户端渲染方案（ Client Side Render 简称： CSR ）；

加载渲染过程如下： HTML/CSS 代码 --> 加载 JavaScript 代码 --> 执行 JavaScript 代码 --> 渲染页面数据

 

SPA 应用的客户端渲染方式，最大的问题有两个方面：

白屏时间过长，用户体验不好；

HTML 中无内容，SEO 不友好；

这个问题的原因在于，首次加载时，需要先下载整个 SPA 脚本程序，浏览器执行代码逻辑后，才能去获取页面真正要展示的数据，而 SPA 脚本的下载需要较长的等待和执行时间，同时，下载到浏览器的 SPA 脚本是没有页面数据的， 浏览器实际并没有太多的渲染工作，因此用户看到的是没有任何内容的页面，不仅如此，因为页面中没有内容，搜索引擎的爬虫爬到的也是空白的内容，也就不利于 SEO 关键字的获取；

相较于传统的站点，浏览器获取到的页面都是经过服务器处理的有内容的静态页面，有过后端编程经验的可能会比较熟悉一些，页面结构和内容，都是通过服务器处理后，返回给客户端；

全宇宙首发动图，全流程展现

 

两相比较我们会发现，传统站点的页面数据合成在后台服务器，而 SPA 应用的页面数据合成在浏览器，但是无论那种，最终的渲染展示，还是交给浏览器完成的，所以，不要误会，我们这里所说的 服务端渲染 和 客户端渲染，指的是页面结构和数据合成的工作，不是浏览器展示的工作；

那么能不能借助传统网站的思路来解决 SPA 的问题又能够保留SPA的优势呢？不管是白屏时间长还是 SEO 不友好，实际都是首屏的页面结构先回到浏览器，然后再获取数据后合成导致的问题，那么，首屏的页面结构和数据，只要像传统站点一样，先在服务端合成后再返回，同时将 SPA 脚本的加载依然放到首屏中，此时返回的页面就是结构和数据都有的完整内容了，这样浏览器在展示首页数据的同时也能加载 SPA 脚本，搜索引擎的爬虫同样也能获取到对应的数据，解决 SEO 的问题；为了更好的理解这个逻辑，我画了一个流程图：

 

没错，这就是我们所说的 服务端渲染的基本逻辑，服务端渲染也就是 SSR （Server Side Rendering） ；

白屏时间过长的问题得以解决，因为首次加载时，服务器会先将渲染好的静态页面返回，在静态页面中再次加载请求 SPA 脚本；

基本原理：首页内容及数据，在用户请求之前生成为静态页面，同时加入 SPA 的脚本代码引入，在浏览器渲染完成静态页面后，请求 SPA 脚本应用，之后的页面交互依然是客户端渲染；

 

明白了其中的原理，也就是到了道、法的境界，接下来，让我们下凡进入术、器的应用层面感受一下；

其中 Vue 框架和 React 框架都有对应的比较成熟的 SSR 解决方案，React对应的是 Next.js 框架，Vue 对应的就是 Nuxt.js，当然，如果你对这些都不感兴趣，也可以自己实现一个 SSR 的服务端应用，我自己之前也写过一个，如果你感兴趣，想看看我实现的代码，可以留言给我，回头做成教程发出来；

 

我们以 Vue 对应的 Nuxt.js 为例，来具体感受服务端渲染；

Nuxt.js 应用

Nuxt.js 是一个基于 Vue.js 的通用应用框架。Nuxt.js 预设了利用 Vue.js 开发服务端渲染的应用所需要的各种配置，为基于 Vue.js 的应用提供生成对应的静态站点的功能。打开 Nuxt.js官网：https://www.nuxtjs.cn/ ，学习指南写的非常详细且通俗易懂，根据指南，我们可以看到有两种安装方式，一种使用 create-nuxt-app 脚手架工具，另一种是自己手动创建；

安装

脚手架安装

接下来我们分别尝试不同的安装方式，先使用脚手架进行安装，执行命令 ： npx create-nuxt-app creact-nuxt

接着，在命令行中会有很多的选择项，分别有项目名称、开发语言、UI组件库、服务器框架、测试框架、HTTP请求库等等，可以根据自己的需要进行不同的选择，安装成功过后，命令行中会给出对应的提示信息。

 

我们可以根据提示信息，运行项目，项目有开发环境和生产环境两种运行方式，开发环境下直接使用 npm run dev 即可，而要运行生产环境，则需要先进行 build 编译，编译成功后才能开启项目运行；

因为项目是刚刚初始化的，我们并没有写任何内容，所以，不管使用那种运行方式，我们能看到的都是下面这个页面内容；

 

手动安装

不同于脚手架安装，手动安装需要我们自己创建项目并安装所需扩展和插件，还需要我们自己写好组件代码，然后配置执行命令，才能启动运行，但是，手动创建更加考验大家对项目的整体把控能力；

执行命令： mkdir nuxtnpm 创建文件夹后，切换目录：cd nuxtnpm ;

然后执行命令：npm init -y 创建项目并生成 package.json 文件；

使用命令：npm install nuxt --save 安装 Nuxt.js 框架；

在 nuxtnpm 目录中，创建 pages 目录及 pages/index.vue 组件文件，在组件文件中，写如下代码，打声招呼：

最后，我们还要在 package.json 文件中，配置运行命令的脚本参数：

"scripts": { 
   "test": "echo \"Error: no test specified\" && exit 1", 
   "dev": "nuxt", 
   "build": "nuxt build", 
   "start": "nuxt start", 
   "generate": "nuxt generate" 
 }, 

配置好命令参数后，就和前面的运行套路是一样的了：

npm run dev 启动一个热加载的 Web 服务器（开发模式）

npm run build 编译项目，利用 webpack 编译应用，压缩 JS 和 CSS 资源（发布用）；

npm run start 以生产模式启动一个 Web 服务器 (需要先进行项目编译)。

项目运行后，我们就可以看到刚刚写的组件内容了；

 

需要注意的是，pages 目录是必须的，Nuxt.js 框架会自动读取该目录下所有的 .vue 文件并自动生成对应的路由配置。

路由

基础路由

基础路由不需要配置，Nuxt.js 会根据 pages 中的文件夹及文件，自动生成的路由配置

假设 pages 的目录结构如下：

pages/ 
--| user/ 
-----| index.vue 
-----| one.vue 
--| index.vue 

那么，Nuxt.js 自动生成的路由配置如下：

router: { 
  routes: [ 
    { 
      name: 'index', 
      path: '/', 
      component: 'pages/index.vue' 
    }, 
    { 
      name: 'user', 
      path: '/user', 
      component: 'pages/user/index.vue' 
    }, 
    { 
      name: 'user-one', 
      path: '/user/one', 
      component: 'pages/user/one.vue' 
    } 
  ] 
} 

同样的，在 /.nuxt/router.js 文件中，我们也能够看到相关内容；

路由导航

Nuxt 中的路由导航有三种方式，一种就是普通的 a 标签跳转，太过于基础这里就不说了，两外两种分别是 nuxt-link 组件和编程式导航，nuxt-link 组件用于在页面中添加链接跳转到其他页面，目前  的作用和 router-link 一致，推荐阅读 Vue 路由文档 来了解它的使用方法，所以，你在Vue 中如何使用，在Nuxt 中同样如何使用就可以了。

而编程式导航的用法，同样与 Vue 中的使用方式一致：

动态路由

在 Nuxt.js 里面定义带参数的动态路由，需要创建对应的 以下划线作为前缀 的 Vue 文件 或 目录。

下划线后面的名字随意命名，但是在获取动态路由参数时，文件的名字就是获取的关键字，用法与 Vue-Router 基本一致:

\pages\user_kk.vue

访问：
http://localhost:3000/user/3

 

在 Nuxt.js 执行 generate 命令时，动态路由会被忽略，(后面重点讲)

嵌套路由

你可以通过 vue-router 的子路由创建 Nuxt.js 应用的嵌套路由。创建内嵌子路由，需要添加一个 Vue 文件，同时添加一个与该文件同名的目录用来存放子视图组件。在父组件(.vue文件) 内增加  用于显示子视图内容。

 

父组件文件内容

\pages\order.vue 

嵌套子组件文件及内容

\pages\order\index.vue 嵌套组件默认显示，访问路径：
http://localhost:3000/order 

\pages\order\info.vue 访问路径： http://localhost:3000/order/info

\pages\order\list.vue 访问路径： http://localhost:3000/order/list 

异步数据-asyncData

Nuxt.js 扩展了 Vue.js，增加了一个叫 asyncData 的方法，使得我们可以在设置组件的数据之前能异步获取或处理数据。asyncData 方法会在组件（限于页面组件）每次加载之前被调用。它可以在服务端或路由更新之前被调用。Nuxt.js 会将 asyncData 返回的数据融合组件 data 方法返回的数据一并返回给当前组件。 

Nuxt.js 对 SSG 的支持

在开始之前，我们需要先了解 SSG 的含义，SSG（Static Site Generators）：静态站点生成。

就是将应用中用到的所有页面，全部生成静态文件的方案；静态站点生成方案，更适合 CDN、缓存、内容数据无变化的页面，比如：宣传页、博客文章、帮助文档、新闻页面、电商产品列表等众多应用场景；因为页面都是事先生成好的，一次构建，反复使用，访问速度快。

那么，在 Nuxt.js 中如何将应用静态化导出呢？npm run generate 命令就是用来专门做静态导出的，这个命令执行后，Nuxt 会根据路由配置，将应用的全部内容生成对应的 HTML 静态站点资源，这个命令会创建一个 dist 文件夹，所有静态化后的资源文件均在其中。

 

前面说 在 Nuxt.js 执行 generate 命令时，动态路由会被忽略。

动态路由手动配置

如果想让 Nuxt.js 为动态路由也生成静态文件，需要指定动态路由参数的值，并配置到 routes 数组中去。

我们可以在 nuxt.config.js 中为 /users/:id 路由配置如下： 

module.exports = { 
   generate: { 
     routes: ['/users/1', '/users/2', '/users/3'] 
   } 
 } 

动态路由数据生成

但是如果路由动态参数的值是动态的而不是固定的，应该怎么做呢？

可以使用一个返回 Promise 对象类型的 函数，意思就是，发送请求获取所有数据，根据返回的数据，生成所有可能的路由，再根据所有路由，生成全部的静态文件

nuxt.config.js 

const axios = require('axios') 
  
 module.exports = { 
   generate: { 
     // 生成路由文件，而不是目录 
     subFolders:false, 
     routes() { 
       // 请求数据 
       return axios.get('http://127.0.0.1:80/three').then(res => { 
         const resData = JSON.parse(res.data); 
         return resData.map(user => { 
           // 拼装路由 
           return '/user/' + user.id 
         }) 
       }) 
     } 
   } 
 } 

异步数据-asyncData 与 mounted 的区别

mounted 在静态站点生成时，不会执行获取数据，代码会被编译进静态生成的 JS 中，浏览器渲染时才会被执行，

asyncData 在导出静态站点时，会执行代码，并将数据直接编译进 HTML 中，代码不会编译到静态文件的 JS 中；

【责任编辑：庞桂玉 TEL：（010）68476606】