决任愧 发表于 2025-6-6 15:30:57

Vue预渲染prerender-spa-plugin+vue-meta-info

前言:
公司现有一个新需求需要在原有的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 --dev2.找到build文件下webpack.prod.conf.js 在页面中添加代码
// 预渲染
const PrerenderSPAPlugin = require('prerender-spa-plugin')
const Renderer = PrerenderSPAPlugin.PuppeteerRenderer



plugins: [

    // 预渲染
    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 --save2.main.js引用
import MetaInfo from 'vue-meta-info'
// 注册
Vue.use(MetaInfo)3.页面上使用
  3.1-直接在页面上使用
//单个页面配置
<template>
    首页
</template>
export default {
    name:'首页'
    metaInfo:{
      title:'首页',
      meta:[
            {
                name: 'keyWords',
                content:'关键字'
            },
            {
                name:'description',
                content:'描述'
            }
      ]
    }
}
//多页面配置
<template>
    首页
</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: 'title',
    meta: [
      {
      name: 'keywords',
      content: ''
      },
      {
      name: 'description',
      content: ''
      }
    ]
},
}然后再页面上面去引用
//导入存放的文件路径
import VueMetaInfo from '../assets/vue-meta-info.js'
export default {
metaInfo: VueMetaInfo.index,
}三、在使用中遇到的问题
1. 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});
 

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: Vue预渲染prerender-spa-plugin+vue-meta-info