vue3.x使用prerender-spa-plugin预渲染达到SEO优化

富朝阳

已于 2024-01-09 16:17:14 修改

阅读量4.5k

点赞数 8

分类专栏： Vue 文章标签：前端 javascript 开发语言 vue.js

于 2023-05-17 09:45:04 首次发布

本文链接：https://blog.csdn.net/chaoPerson/article/details/130717748

版权

Vue 专栏收录该内容

13 篇文章 2 订阅

订阅专栏

文章介绍了Vue单页面应用在SEO方面的挑战，并提出了两种解决方案：官方的SSR服务端渲染，以及使用prerender-spa-plugin进行预渲染。预渲染方案详细阐述了安装、配置和使用过程，包括修改路由模式、安装vue-meta-info插件来处理meta信息，最后通过npmrunbuild打包。

摘要由CSDN通过智能技术生成

1.安装prerender-spa-plugin

2.在router.js看下路由模式是不是 ‘history’，不是的请换成history

3.在vue.config.js配置（本人使用的是3.0脚手架自行创建的）

4.安装vue-meta-info插件

5.使用vue-meta-info插件，改变link、title、meta等

6.npm run build 打包

前言

传统html是通过a标签跳转来作为切换的，每一个页面都是一个html，这样百度很容易抓取到的，也能顺着a链接到你的子级页面。像vue、react、angular开发的都是spa应用，他只有一个页面index，他们都是内加载，动态加载切换路由的，所以你再多页面百度蜘蛛只能爬到首页，这就是spa的一大痛点。

单页面应用SEO。

解决方案

说下怎么解决这个问题，目前我所了解的两种：

方案一：官网提供的 SSR（服务端渲染）

vue.js官网提供的 SSR（服务端渲染），这是一种完美的解决方案，用官方的话说你不需要服务器，但是仍能获得 SEO 的好处，这是因为 Nuxt 将预先渲染所有页面，并且包括必要的 HTML。此外，你可以轻松地将生成的页面部署到 Netlify 或 GitHub pages 上。

但是这种方案呢学习成本高，对于刚开始的新手来说可能有点难度，基本还得重构项目。感兴趣的同学可以去官网去学习使用，以下是Nuxt.js官网链接：Nuxt.js - Vue.js 通用应用框架 | Nuxt.js 中文网。

方案二：第三方插件实现

预渲染：用vue官方的一句话来说，它无需使用 web 服务器实时动态编译 HTML，而是使用预渲染方式，在构建时 (build time) 简单地生成针对特定路由的静态 HTML 文件。优点是设置预渲染更简单，并可以将你的前端作为一个完全静态的站点。

为了节约开发成本推荐选择第二种方案。prerender-spa-plugin它所做的预渲染就是当vue-cli构建的项目进行npm run build 的时候，会按照路由的层级进行动态渲染出对应的html文件，这样爬虫在爬取页面的时候就不会再是一个简简单单的 index.html 入口文件了。

1.安装prerender-spa-plugin

npm config set puppeteer_download_host=https://npm.taobao.org/mirrors
npm i puppeteer
npm i prerender-spa-plugin --save -dev

2.在router.js看下路由模式是不是 ‘history’，不是的请换成history

mode : ‘history’,

3.在vue.config.js配置（本人使用的是3.0脚手架自行创建的）

const path = require('path');
const PrerenderSPAPlugin = require('prerender-spa-plugin');
const Renderer = PrerenderSPAPlugin.PuppeteerRenderer;
module.exports = {
    publicPath: '/', //打包路径，使用相对路径生成的dist文件夹下的index可以打开
    configureWebpack: {
      plugins: [
         new PrerenderSPAPlugin({
        // 生成文件的路径，也可以与webpakc打包的一致。
        // 下面这句话非常重要！！！
        // 这个目录只能有一级，如果目录层次大于一级，在生成的时候不会有任何错误提示，在预渲染的时候只会卡着不动。
         staticDir: path.join(__dirname,'dist'),
           // 对应自己的路由文件，比如a有参数，就需要写成 /a/param1。
          routes: [
            '/', 
            '/home',
            '/article',
            '/download',
            '/message',
          ],
          // 这个很重要，如果没有配置这段，也不会进行预编译
         renderer: new Renderer({
          injectProperty: '__PRERENDER_INJECTED',
          inject: {
            foo: 'bar'
          },
           // 在 app.vue  onMounted函数中 document.dispatchEvent(new Event('custom-render-trigger'))，两者的事件名称要对应上。
          renderAfterDocumentEvent: 'custom-render-trigger',
          renderAfterTime: 6000,
          headless: false
         })
       }),
      ]
   },
}

这里 publicPath得注释掉，否则打包后图片和资源链接会失效。

App.vue setup onMounted函数

  setup() {
    onMounted(() => {
      document.dispatchEvent(new Event('custom-render-trigger'))
    })
  },

4.安装vue-meta-info插件

npm i vue-meta-info

5.使用vue-meta-info插件，改变link、title、meta等

main.ts

import MetaInfo from 'vue-meta-info'
Vue.use(MetaInfo);

在你的路由页面中加

export default defineComponent({
  name: "Home",
  metaInfo: {
    //改变当前路由的title
    title: "前端小阳仔",
    //改变当前路由的link
    meta: [
      {
        name: "keyWords",
        content:
          "前端博客,前端技术,技术博客,前端小知识,前端作品,前端导航,前端小阳仔,前端框架",
      },
      {
        name: "description",
        content:
          "原创前端技术博客，致力于分享前端学习路上的第一手资料。专注web前端开发、移动端开发、前端工程化、前端职业发展，做最有价值的前端技术学习网站。",
      },
    ],
    link: [
      {
        rel: "前端小阳仔",
        href: "https://code-nav.top/myblog/home",
      },
    ],
  }
});