前言:
公司现有一个新需求需要在原有的vue2项目上面进行预渲染,进行SEO的优化,在网上进行了一系列的搜索,发现两种简单易上手的方案(1.使用prerender-spa-plugin+vue-meta-info进行打包构建;2.使用nuxt.js在开发过程中就渲染呈现出来)
因是在原有项目基础上进行,所以采用第一种方案进行构建渲染,话不多说,直接上代码!!!
一、prerender-spa-plugin插件使用
1.安装
//npm npm install prerender-spa-plugin --save //yarn yarn add prerender-spa-plugin --dev
2.找到build文件下webpack.prod.conf.js 在页面中添加代码
// 预渲染 const PrerenderSPAPlugin = require('prerender-spa-plugin') const Renderer = PrerenderSPAPlugin.PuppeteerRendererplugins: [// 预渲染new PrerenderSPAPlugin({// 生成文件的路径,也可以与webpakc打包的一致。// 下面这句话非常重要!!!// 这个目录只能有一级,如果目录层次大于一级,在生成的时候不会有任何错误提示,在预渲染的时候只会卡着不动。staticDir: path.join(__dirname, '../dist'),// 对应自己的路由文件,比如a有参数,就需要写成 /a/param1。routes: ['/', '/index'], // 这个很重要,如果没有配置这段,也不会进行预编译renderer: new Renderer({inject: {foo: 'bar'},// headless: false,// renderAfterDocumentEvent: 'render-event', // 在 main.js 中 document.dispatchEvent(new Event('render-event')),两者的事件名称要对应上。// args: ['--no-sandbox', '--disable-setuid-sandbox'] navigateOptions:{timeout: 0,}}) ]
3.在main.js里面添加mounted newEvent('document') document名字必须与第二步中的名字对呀
// 添加mounted,不然不会执行预编译 mounted () {document.dispatchEvent(new Event('render-event'))}
4.router.js中一定要设置history模式
5.npm run build
打包之后可以看到配置好的路由生成了相应的html页面
二、vue-meta-info使用
1.插件安装
npm install vue-meta-info --save
2.main.js引用
import MetaInfo from 'vue-meta-info' // 注册 Vue.use(MetaInfo)
3.页面上使用
3.1-直接在页面上使用
//单个页面配置 <template><div>首页</div> </template> export default {name:'首页'metaInfo:{title:'首页',meta:[{name: 'keyWords',content:'关键字'},{name:'description',content:'描述'}]} } //多页面配置 <template><div>首页</div> </template> export default {name:'index'metaInfo():{return{meta:this.metaData}},data(){return{metaData:''}},watch:{$route(to,form){//通过跳转页面配置每个页面的关键字和描述,这只是个例子//注意如果通过to.path去判断 需要进行兼容判断 因为渲染后的访问路径会在末尾自动添加/ 例如 loclhost:3000/index/,这个时候就需要 to.path === '/index' || to.path==='/index/'if(to.name === 'index'){this.metaData=[{name: 'keyWords',content:'关键字'},{name:'description',content:'描述'}]}//当然也可以封装一个方法去返回每个页面的文案//this.metaData = metaSetFuc(to.name) }} }
3.2-新建一个js文件里面
export default {index: {title: 'Pearlsvibe - Unleash Your Natural Desires',meta: [{name: 'keywords',content: ''},{name: 'description',content: ''}]}, }
然后再页面上面去引用
//导入存放的文件路径 import VueMetaInfo from '../assets/vue-meta-info.js' export default {metaInfo: VueMetaInfo.index, }
三、在使用中遇到的问题
1.[prerender-spa-plugin] Unable to prerender all routes! 错误
在node_modules -> @prerender -> renderer-puppeteer -> es6 -> renderer.js(113行)
await page.goto(`${baseURL}${route}`, navigationOptions); //修改为 await page.goto(`${baseURL}${route}`, {...navigationOptions, timeout: 0});