webpack中插件 prerender-spa-plugin 来进行SEO优化(二十四)
vue、react对于开发单页应用来说带来了很好的用户的体验，但是同样有缺点，比如首页加载慢，白屏或SEO等问题的产生。为什么会出现这种情况呢？我们之前开发单页应用是这样开发的，比如首页 index.html页面或许是这样的：
<!DOCTYPE html> <html> <head> <title>webpack+vue项目架构</title> <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=0"> </head> <body> <div id="app"> </div> </body> </html>
在理解之前，我们还是和之前一样，先把我们的整个项目架构是一个什么样的，来简单的介绍下，方便有个简单的理解：
### 目录结构如下： demo1 # 工程名 | |--- dist # 打包后生成的目录文件 | |--- node_modules # 所有的依赖包 | |--- app | | |---index | | | |-- views # 存放所有vue页面文件 | | | | |-- home.vue | | | | |-- index.vue | | | | |-- java.vue | | | | |-- node.vue | | | |-- components # 存放vue公用的组件 | | | |-- js # 存放js文件的 | | | |-- app.js # vue入口配置文件 | | | |-- router.js # 路由配置文件 | |--- views | | |-- index.html # html文件 | |--- webpack.config.js # webpack配置文件 | |--- .gitignore | |--- README.md | |--- package.json | |--- .babelrc # babel转码文件
然后我们会通过webpack打包，将单页应用中的入口文件打包到一个js文件中去，如下配置：
module.exports = {
// 入口文件
entry: {
main: './app/index/app.js'
},
output: {
filename: process.env.NODE_ENV === 'production' ? '[name].[contenthash].js' : 'bundle.js',
// 将输出的文件都放在dist目录下
path: path.resolve(__dirname, 'dist')
},
plugins: [
new HtmlWebpackPlugin({
hash: true, //为了开发中js有缓存效果，所以加入hash，这样可以有效避免缓存JS。
template: './views/index.html' // 模版文件
}),
new ClearWebpackPlugin(['dist']),
new ExtractTextPlugin("style.css"),
]
};
基本的配置代码如上所示，它会把 我项目中 /views/index.html 当做模板页面，然后会把css文件样式和js文件会自动打包到index.html文件中，如下打包后的文件代码如下：
dist/index.html 源码如下：
<!DOCTYPE html> <html> <head> <title>webpack+vue项目架构</title> <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=0"> <link href="style.css?26aab5a9debce5432af2" rel="stylesheet"></head> <body> <div id="app"> </div> <script type="text/javascript" src="bundle.js?26aab5a9debce5432af2"></script></body> </html>
如上打包的主页index.html文件，我们可以看到，页面上只用一个 div, 然后有一个样式文件，和一个js文件。并没有其他的。
那么如上代码，我们很容易想到会出现如下几种缺点：第一：SEO不友好，也就是说，我通过百度或google搜索引擎搜索不到我网站的主页到，第二是：很容易出现白屏情况，为什么呢？因为我页面中的所有的内容都是通过 bundle.js这个动态加载进行，那么浏览器在加载及解析这段时间内，页面会一直是空白的。也就是我们说的白屏。当然对于我们首页来讲，加载也是非常慢的。因此为了解决这个问题，webpack中的有个插件 prerender-spa-plugin 可以解决上面这些问题。
我们再使用这个插件之前，我们来理解下我们之前是怎么样进行SEO优化的呢？我们很早很早之前，我们是使用 velocity 语法来编写页面，然后写完后把该页面部署到开发那边去，那么这样就要来回折腾了，并且我们前端开发成本也非常高。
那么第二种方式是使用SSR技术(服务器端渲染)，比如Nuxt.js，最主要的思想是，是通过Node.js完成渲染逻辑，然后会将html视图直接返回给客户端。这样的方式也可以解决SEO的问题。但是对于开发成本还是比较大。比如需要考虑Node.js环境中的内存泄露，运行速度，并发压力等问题。并且开发成本增加，研发周期变长等这些问题。因此我们在webpack中有一种插件能将seo，首屏加载的问题可以解决掉了。
2. 如何使用 prerender-spa-plugin ？
1. 安装命令如下：
npm install prerender-spa-plugin --save-dev
2. 在我们的webpack.config.js 需要配置如下：
const PrerenderSPAPlugin = require('prerender-spa-plugin');
const Renderer = PrerenderSPAPlugin.PuppeteerRenderer;
var config = {
// 入口文件
entry: {
main: './app/index/app.js'
},
output: {
filename: process.env.NODE_ENV === 'production' ? '[name].[contenthash].js' : 'bundle.js',
// 将输出的文件都放在dist目录下
path: path.resolve(__dirname, 'dist')
},
module: {
// ....
},
resolve: {
extensions: ['*', '.js', '.json', '.vue', '.styl']
},
devtool: 'cheap-module-eval-source-map',
devServer: {
// ....
},
plugins: [
new HtmlWebpackPlugin({
hash: true, //为了开发中js有缓存效果，所以加入hash，这样可以有效避免缓存JS。
template: './views/index.html' // 模版文件
}),
new ClearWebpackPlugin(['dist']),
new ExtractTextPlugin("style.css"),
// .....
]
}
// 这里判断 如果是 正式环境打包的话，就使用该插件
if (process.env.NODE_ENV === 'production') {
config.plugins.push(
new PrerenderSPAPlugin({
staticDir: path.join(__dirname, '/dist'),
// 列出需要预渲染的路由
routes: [ '/home' ],
renderer: new Renderer({
inject: {
foo: 'bar'
},
// 监听到自定事件时捕获
renderAfterDocumentEvent: 'render-event'
})
})
)
}
module.exports = config;
下面我们来理解下PrerenderSPAPlugin中的几个配置的含义：
staticDir：指的是预渲染输出的页面地址。
routes: 指的是需要预渲染的路由地址。
renderer：指的是所采用的渲染引擎是什么。目前用的是 V3.4.0 版本支持 PuppeteerRenderer。
inject：指的是预渲染过程中能拿到的值。是否需要渲染这部分代码，可以通过该值进行判断。比如如下代码：
isshowRender() {
if(window.__PRERENDER_INJECTED && window.__PRERENDER_INJECTED.foo =='bar') return;
this.message = '我是测试预加载拦截';
}
上面执行的方法中的代码是不会被渲染的。
renderAfterDocumentEvent的含义是监听 document.dispatchEvent 事件，决定什么时候开始预渲染。
3. 因此在我们的app.js 代码要改成如下：
import Vue from 'vue';
import Index from './views/index';
// 引入路由
import router from './router';
new Vue({
el: '#app',
router: router,
render: h => h(Index),
mounted() {
document.dispatchEvent(new Event('render-event'))
}
});
在实例化 new Vue的时候 在mounted生命周期中加上代码：document.dispatchEvent(new Event('render-event'))，触发render-event事件进行渲染。
4. 路由配置(router.js)：
import Vue from 'vue';
import VueRouter from 'vue-router';
// 引入组件
import home from './views/home';
import path from 'path';
// 告诉 vue 使用 vueRouter
Vue.use(VueRouter);
const routes = [
{
path: '/home',
name: 'home',
component: resolve => require(['./views/home'], resolve),
// 子路由
children: [
{
path: 'java',
name: 'java',
component: resolve => require(['./views/java'], resolve)
},
{
path: 'node',
name: 'node',
component: resolve => require(['./views/node'], resolve)
}
]
},
{
path: '*', // 其他没有的页面都重定向到 home页面去
redirect: '/home'
}
]
var router = new VueRouter({
mode: 'history', // 访问路径不带井号 需要使用 history模式
// base: path.resolve(__dirname, '/app/index'), // 配置单页应用的基路径
routes: routes
});
export default router;
如上路由配置据说要改成 模式变成 mode: 'history'这个模式，该插件才会渲染。
当我们认为配置一切成功的时候，我们在项目的根目录中运行 npm run build 的时候，发现打包报错了，如下提示：
Chromium revision is not downloaded. Run "npm install" or "yarn install" 提示这样的信息，我们可以根据这个信息去百度搜索下，看看是什么错误，百度结果后，他们的意思是需要我们安装 puppeteer 这个插件，但是安装这个插件也是有条件的。我们需要使用国内Chromium源.如下命令：
npm install -g cnpm --registry=https://registry.npm.taobao.org cnpm i puppeteer
如下图所示：
一切安装完成后，我们再运行 npm run build 后可以看到在我们的dist目录下 会多生成一个 home文件夹了，该文件夹有一个 index.html文件，如下所示：
生成完成后，我们查看下 dist/home/index.html页面变成如下：
<!DOCTYPE html><html><head> <title>webpack+vue项目架构</title> <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=0"> <link href="style.css?e8ed6db9e5869aa22ba2" rel="stylesheet"><script charset="utf-8" src="1.465ef3291c29aadf53df.js"></script></head> <body> <div id="app"><header><li class="router-link-exact-active router-link-active">Home</li> <a href="/home/java" class="">java</a> <a href="/home/node" class="">node</a></header> <div class="home-container"><h1>欢迎来到Home</h1> <p>我是Home组件</p> <!----></div></div> <script type="text/javascript" src="main.5aea82d6c5e9feeac132.js?e8ed6db9e5869aa22ba2"></script> </body></html>
如上代码，可以看到，我们的路由 /home 确实所有的静态页面都渲染了。因此实现SEO，页面不会白屏的问题已经解决了。
github源码查看
- webpack copy-webpack-plugin拷贝资源插件
- webpack 启动后自动打开浏览器插件：open-browser-webpack-plugin
- Webpack 常见静态资源处理 - 模块加载器（Loaders）+ExtractTextPlugin插件
- webpack插件总结之DefinePlugin，ProvidePlugin
- webpack插件html-webpack-plugin
- HtmlWebpackPlugin插件使用实现html文件自动生成
- webpack 插件 plugin
- html-webpack-plugin插件使用chunks属性时报错
- vue run dev后自动打开浏览器插件：open-browser-webpack-plugin
- webpack4+学习笔记：8. CSS样式抽离之 mini-css-extract-plugin 插件
- html-webpack-plugin插件
- webpack 插件之Html-Webpack-Plugin
- webpack.DllPlugin和webpack.DllReferencePlugin静态资源预编译插件
- webpack 插件： html-webpack-plugin
- 安装html-webpack-plugin插件时报错
- 深入浅出的webpack构建工具---AutoDllPlugin插件(八)
- html-webpack-plugin插件的详细介绍和使用
- webpack.optimize.CommonsChunkPlugin插件的使用
- extract-text-webpack-plugin插件提取css单独打包
- webpack学习（三）html-webpack-plugin插件