缘起

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

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

image

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

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

image

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

来自官方的解释：

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

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

羞涩难懂

我的个人理解就是：

1、目前Vue的模式是：

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

image

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

image

这第二种就是 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 了。

image

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

image

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

大家可以看看咱们的第二个项目，就是通过 Nuxt 实现的服务端渲染，已经在源代码中，有了内容：

image

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                                // 说明文档

image

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

//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() // 如果没有组件，说明该路由不存在，报错404if (!matchedComponents.length) { return reject({ code: 404 }) }resolve(app)})} //2、三个 vue 页面，和app vue页面，就是简单的写法，大家可以直接随意 //3、//main.js
import Vue from 'vue' import createRouter from './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)export default 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 文件

image

6、启动服务

 node server

这个时候我们就可以看到效果了

image

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

image

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

四、结语

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

五、CODE

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

下载后，先 npm install 安装依赖

然后执行打包和启动服务命令

npm run server
node server

最后访问 localhost:8089

QQ群：
867095512 (blod.core)