缘起

时间真快,现在已经是这个系列教程的下半部 Vue 第 12 篇了,昨天我也简单思考了下,可能明天再来一篇,Vue
就基本告一段落了,因为什么呢,这里给大家说个题外话,当时写博文的时候,只是想给大家增加点儿学习的动力,每天提醒下,完全没有提纲或者安排说明什么的,就是按照我自己学的方向走,正好发现了一个规律就是:每一个系列正好是
1 个引子 + 12
篇正文,不知道大家对这个有没有感觉,大家可能看到我的头像就知道了,哈哈,其实我是一个红迷,正好这里机缘巧合,两个系列都形成了这样的,我自私的给自己画了一个规划,正好是一组判词——十二钗正册,副册,又副册等等(说明:这是我自己的一厢情愿哈,大家如果有红迷爱好者,请不要喷我
[苦笑] ),按照计划,应该会写 9 部,除了引子,正好是 108
篇,哈哈以后的再说吧。这里自己昨天瞎想了一通,如果有红迷爱好者也可以找我哟,加群(867095512)或者个人QQ(3143422472)都行。

因为 Vue 这个系列还是很多的要说的,不过基本的咱们都说了,大家可以再通过传送门看看《Vue 学习12篇
<https://www.cnblogs.com/laozhang-is-phi/category/1292730.html>
》,今天呢,咱们就说说一个老生常谈的问题,就是如何实现 Vue 的 SSR 服务端渲染,大家如果是第一次接触到,可能还比较陌生,不要慌,本文就给大家通过
Nuxt.js 框架,来讲解这个问题,然后为了以后实现咱们的第二个项目,大致会是这个样子(注意页面的源代码已经有内容了):

 



 

注意:今天仅仅给大家说明 SSR 服务端渲染,会简单说一个小 DEMO
,上图中的框架具体的代码,在咱们的第二个博客项目中会说到,因为这个框架一两篇是说不完的。

 

零、今天要完成蓝色区块部分



 

 

一、Vue 的 SSR 到底是个什么?

 

来自官方的解释:

Vue.js 是构建客户端应用程序的框架。默认情况下,可以在浏览器中输出 Vue 组件,进行生成 DOM 和操作
DOM。然而,也可以将同一个组件渲染为服务器端的 HTML 字符串,将它们直接发送到浏览器,最后将这些静态标记"激活"为客户端上完全可交互的应用程序。

服务端渲染的 Vue.js 应用程序也可以被认为是"同构"或"通用",因为应用程序的大部分代码都可以在服务器和客户端上运行。

羞涩难懂

我的个人理解就是:

1、目前Vue的模式是:

在生成页面的工作中,我们现在是把组件放在浏览器里,然后把 Data 填充到组件中生成
DOM,这也是一般的异步操作的动作,咱们平时一定是这么操作的,先在页面写上 DIV,然后用 Jquery 获取数据,把数据填充到 DIV 里



 

2、SSR的模式呢,转变成了先在服务器中 Data 先把组件先渲染成 Html 字符串,当成静态资源,就像 css 字符串那样,再抛到前台页面。



这第二种就是 SSR 服务端渲染,大家应该发现了这个和普通的区别——就是渲染html片段的控制权转向了服务端,那为什么要这么做呢?请往下看。

 注意:这里的服务端,并不是在我们的.net core api 中生成的,而是在vue中,我们通过webpack 打包后 node server来处理的。

二、为什么要 SSR 服务端渲染?

1、首先咱们需要说说搜索引擎 —— SEO


咱们打开任何搜索引擎,无论是谷歌,还是百度,亦或者搜狗等等,都能看到各种各样的信息,文字,图片,视频,不知道大家是如何看待这个过程的,以前天真的我以为是各种各样的人,把自己的内容或者文档提交给百度的服务器,然后我们从百度的服务器去读取,搜索,嗯,这个源自于我上高中的时候,搜索各种百度文库的臆想,这个属于我认识的搜索
1.0 。

后来我工作了,第一次开始写 Web ,那个时候经理让写 TDK(Title + Description +
Key),当时很好奇为什么要这么说,经理说,是为了 SEO ,额好吧,虽然不是很明白,大概懂了——设置好页面的 TDK
以后,那个搜索引擎就能找到我们的关键字,然后我们就可以在搜索引擎中搜到我们的网站了,嗯~听起来不错,这个时候,我凌乱了,不是说我们必须存进百度的数据库,我们才能搜索到么,太神奇了吧,这就是我认识的搜索
2.0 。


转眼过去一段时间,接触的也越来越多,这个时候我负责了一个旅游游记的项目,老板说,我们的数据才千级别,比较少,用户搜索咱们的不是很方便,让我搞些网上的数据(当然是合法的哈,只是用来展示,划重点),这个时候我才知道了竟然有
爬虫 这个东西!原来网上的资源可以随心所欲的获取(合法的 × 3
!),这个时候回头看引擎,哦!原来他们的都是爬取的网上的信息,举个栗子:大家可以在百度上搜索  “老张的哲学 .net core
”,会看到咱们的文章,可以看到不仅有题目,还有文章正文,这也就是说,百度爬取的不仅仅是咱们的 TDK ,还有咱们的文章内容,大概这就是我认识的搜索 3.0 了。



 

所以说,咱们如果需要想让咱们的文章,网站等被搜索引擎爬取,然后被大家所搜索到,必须要设置 TDK 和有页面内容,但是这个时候,我们满心开新的打开我们的
Vue 博客第一版的项目时候,却发现了这个样子。。



 


咱们辛辛苦苦写的文章并没有被浏览器所生成,自然以后不会被爬取到,如果要是我们的商城也是这样,那得少了多少流量,都是钱哟,所以说,如果是带有文章类,内容类,商品类的
Web 项目,一定要解决这个问题,这个就是为什么要 SSR 的第一个原因。

大家可以看看文章最顶部的第二个项目的gif图,就是通过 Nuxt 实现的服务端渲染,已经在源代码中有了内容。 

 

2、为 Vue 渲染瓶颈提供帮助

在上面两个流程中,咱们可以看到,普通的客户端渲染,和SSR 的服务端渲染的最大区别就在于,Html 片段到底被谁控制,是 Vue
还是服务端,如果是前端,h5请求 API 的时候,因为涉及到跨域,本身除了服务器的限制,还有用户网络,宽带等诸多限制,咱们需要等待入口页面和 JS
下载成功,才能根据逻辑去获取数据,中间又会出现很多问题。

并且如果当前页面逻辑过多,数据过于繁琐的情况下,我们的 vue
在客户端渲染也会成为性能瓶颈,最明显的就是一些电商公司的首页(比如某宝,那首页打开真是复杂的要命)首次加载的时候,白屏的出现,loading图的渲染,着实让人难堪,虽然现在都采用栅栏预热,但还是不舒服。这是瓶颈问题,如果单单从
Vue 端来解决这个瓶颈,花费比较大,所以这个时候就用到了 SSR 服务端渲染,而且我们可以使用 Redis 去缓存这些页面的 Html
片段,我们加载后会更快。

 

 三、如何实现 SSR 服务端渲染 —— 基于 webpack 的简单程序

注意:今天咱们主要是说明下 SSR 的内容、原理和基本使用,这里简单说一个小Demo栗子,咱们之后的项目会用到一个框架 Nuxt.js

1、基于 webpack 初始化 npm 项目

新建文件夹 VueSSRDemo3 ,进入之后,执行  npm i ,初始化项目
npm i
会看到一个 package-lock.json 文件,大家还记得这个么,这个简单来说,是保证项目的一致性,保证团结开发的时候都依赖相同的包,这里再补充下:

1、npm 5.0.x 版本,不管package.json怎么变,npm i 时都会根据lock文件下载

package-lock.json file not updated after package.json file is changed · Issue
#16866 · npm/npm

这个 issue 控诉了这个问题,明明手动改了package.json,为啥不给我升级包!然后就导致了5.1.0的问题...

2、npm 5.1.0 版本后 npm install 会无视lock文件 去下载最新的npm

然后有人提了这个issue why is package-lock being ignored? · Issue #17979 · npm/npm

控诉这个问题,最后演变成5.4.2版本后的规则。

3、npm 5.4.2 版本后 why is package-lock being ignored? · Issue #17979 · npm/npm

大致意思是,如果改了package.json,且package.json和lock文件不同,那么执行`npm
i`时npm会根据package中的版本号以及语义含义去下载最新的包,并更新至lock。

 

2、新建 package.json 依赖包文件
{ "name": "ssr", "version": "1.0.0", "description": "", "main": "index.js", "
scripts": { "server": "webpack --config ./webpack/webpack.server.js", "client":
"webpack --config ./webpack/webpack.client.js" }, "author": "laozhang", "license
": "ISC", "dependencies": { "axios": "^0.16.0", "babel": "^6.23.0", "
babel-plugin-transform-runtime": "^6.23.0", "babel-polyfill": "^6.26.0", "
babel-preset-env": "^1.7.0", "body-parser": "^1.18.3", "compression": "^1.7.2",
"express": "^4.15.4", "express-http-proxy": "^1.2.0", "gulp": "^3.9.1", "
gulp-shell": "^0.6.5", "http-proxy-middleware": "^0.18.0", "less": "^3.0.4", "
less-loader": "^4.1.0", "shell": "^0.5.0", "superagent": "^3.8.3", "vue": "
^2.2.2", "vue-meta": "^1.5.0", "vue-router": "^2.2.0", "vue-server-renderer": "
^2.2.2", "vue-ssr-webpack-plugin": "^3.0.0", "vuex": "^2.2.1", "vuex-router-sync
": "^4.2.0" }, "devDependencies": { "babel-core": "^6.26.3", "babel-loader": "
^6.4.1", "babel-preset-es2015": "^6.24.1", "css-loader": "^0.28.4", "
style-loader": "^0.18.2", "vue-loader": "^11.1.4", "vue-template-compiler": "
^2.2.4", "webpack": "^2.7.0" } }
3、执行 npm install 安装依赖包
npm install
然后就会增加 node_modules 文件夹,这个大家就很熟悉了。

 

4、新增部分文件,并依次填写内容

结构如下:
├── dist      // 保存我们的打包后的文件 ├── node_modules      // 依赖包文件夹 ├── entry      //
│ └── entry-server.js     // 服务端文件 ├── src       // 我们的项目的源码编写文件 │ ├── views //
view存放目录 │ │ ├── about.vue         //about 页面 │ │ ├── like.vue         //like 页面
│ │ └── Home.vue    //Home 页面 │ └── App.vue          // App入口文件 │ └── main.js
         // 主配置文件 │ └── router.js           // 路由配置文件 └── .babelrc // babel 配置文件
└── package.json// 项目依赖包配置文件 └── package-lock.json // npm5 新增文件,优化性能 └──
server.js// server 文件 └── README.md // 说明文档


整体结构就是这样,然后就是开始写入代码了,一共七个文件,大家可以自己试一试,或者直接下载 git 代码

 

更新:

下边没有具体的更新,只有代码和部分注释,大家可以看看我的下一篇文章,更好懂些:

《从壹开始前后端分离 [ Vue2.0+.NetCore2.1] 二十六║Client渲染、Server渲染知多少{补充}
<https://www.cnblogs.com/laozhang-is-phi/p/9675822.html>》

 
//1、/* entry-server.js */ import { createApp } from '../src/main' export
default context => { return new Promise((resolve, reject) => { const app =
createApp()// 更改路由 app.$router.push(context.url) // 获取相应路由下的组件 const
matchedComponents = app.$router.getMatchedComponents() // 如果没有组件,说明该路由不存在,报错404
if (!matchedComponents.length) { return reject({ code: 404 }) } resolve(app) })
}//2、三个 vue 页面,和app vue页面,就是简单的写法,大家可以直接随意 //3、//main.js import Vue from 'vue'
import createRouterfrom './router' import App from './App.vue' //
导出一个工厂函数,用于创建新的vue实例 export function createApp() { const router = createRouter()
const app = new Vue({ router, render: h => h(App) }) return app } /*4、 route.js
*/ import Vue from 'vue' import VueRouter from 'vue-router' Vue.use(VueRouter)
exportdefault function createRouter() { let router = new VueRouter({ //
要记得增加mode属性,因为#后面的内容不会发送至服务器,服务器不知道请求的是哪一个路由 mode: 'history', routes: [ { alias:
'/', path: '/home', component: require('./views/home.vue') }, { path: '/like',
component: require('./views/like.vue') }, { path: '/about', component: require('
./views/about.vue') } ] }) return router } /* 5、webpack.server.js */ const path
= require('path'); const projectRoot = path.resolve(__dirname, '..');
module.exports= { // 此处告知 server bundle 使用 Node 风格导出模块(Node-style exports)
target:'node', entry: ['babel-polyfill', path.join(projectRoot, '
entry/entry-server.js')], output: { libraryTarget: 'commonjs2', path:
path.join(projectRoot,'dist'), filename: 'bundle.server.js', }, module: {
rules: [{ test:/\.vue$/, loader: 'vue-loader', }, { test: /\.js$/, loader: '
babel-loader', include: projectRoot, exclude: /node_modules/, options: {
presets: ['es2015'] } }, { test: /\.less$/, loader: "
style-loader!css-loader!less-loader" } ] }, plugins: [], resolve: { alias: { '
vue$': 'vue/dist/vue.runtime.esm.js' } } } //6、babelre文件 { "presets": [ "
babel-preset-env" ], "plugins": [ "transform-runtime" ] } /*7、 server.js */
const express = require('express')() const renderer = require('
vue-server-renderer').createRenderer() const createApp = require('
./dist/bundle.server.js')['default'] // 响应路由请求 express.get('*', (req, res) => {
const context = { url: req.url } // 创建vue实例,传入请求路由信息
createApp(context).then(app => { renderer.renderToString(app, (err, html) => {
if (err) { return res.state(500).end('运行时错误') } res.send(` <!DOCTYPE html>
<html lang="en"> <head> <meta charset="UTF-8"> <title>Vue2.0 SSR渲染页面</title>
</head> <body> ${html} </body> </html> `) }) }, err => { if(err.code === 404) {
res.status(404).end('所请求的页面不存在') } }) }) // 服务器监听地址 express.listen(8089, () =>
{ console.log('服务器已启动!') })
 

5、打包文件
npm run server
这个时候,你会发现,我们的dist 文件夹内,多了一个 bundle.server.js 文件



 

6、启动服务
node server
这个时候我们就可以看到效果了



7、查看源代码,发现我们的页面已经渲染成功了!



这样我们已经达到了 SSR 的作用

 

 

四、结语

因为今天时间的问题,咱们我先把核心文件搭建好了,大家知道了什么是 SSR,以及存在的问题和解决办法,但是具体的文件 entry-server.js 、
webpack-server.js、和server.js 都是什么意思,明天咱们再统一说明,并且顺带给大家引入新的框架 Nuxg.js,一个成熟的 SSR
框架。

 

五、Github

https://github.com/anjoy8/Blog.Vue/tree/master/Demo/Vue_SSR
<https://github.com/anjoy8/Blog.Vue/tree/master/Demo/Vue_SSR>

下载后,先 npm install 安装依赖

然后执行打包和启动服务命令
npm run server
node server
 最后访问 localhost:8089