vue单页面做百度seo

原文内柔

https://www.wangxiaofeng.site/vue-prerender-spa-seo.html

 

前言：

为什么使用预渲染？官方是这样说的：如果你调研服务器端渲染 (SSR) 只是用来改善少数营销页面（例如 /, /about, /contact 等）的 SEO，那么你可能需要预渲染。无需使用 web 服务器实时动态编译 HTML，而是使用预渲染方式，在构建时 (build time) 简单地生成针对特定路由的静态 HTML 文件。优点是设置预渲染更简单，并可以将你的前端作为一个完全静态的站点。

我的实际情况：网站首页以及帮助页面（/help）包含网站功能描述的文字内容，因此需作为主要的优化对象。其他页面需要用户登录之后才能看到，因此对这些页面做SEO意义不大。

适用环境：vue-cli3

实现步骤：

1，安装插件

cnpm install prerender-spa-plugin --save

2，修改 vue-config.js

const PrerenderSPAPlugin = require('prerender-spa-plugin');
        const Renderer = PrerenderSPAPlugin.PuppeteerRenderer;
        const path = require('path');
        module.exports = {
            configureWebpack: config => {
                if (process.env.NODE_ENV !== 'production') return;
                return {
                    plugins: [
                        new PrerenderSPAPlugin({
                            // 生成文件的路径，也可以与webpakc打包的一致。
                            // 下面这句话非常重要！！！
                            // 这个目录只能有一级，如果目录层次大于一级，在生成的时候不会有任何错误提示，在预渲染的时候只会卡着不动。
                            staticDir: path.join(__dirname, 'dist'),
                            // 对应自己的路由文件，比如a有参数，就需要写成 /a/param1。
                            routes: ['/', '/help'],
                            // 这个很重要，如果没有配置这段，也不会进行预编译
                            renderer: new Renderer({
                                inject: {
                                    foo: 'bar'
                                },
                                headless: false,
                                 // 在 main.js 中 document.dispatchEvent(new Event('render-event'))，两者的事件名称要对应上。
                                renderAfterDocumentEvent: 'render-event'
                            })
                        }),
                    ],
                };
            }
        }

3.在main.js中增加

new Vue({
    router,
    render: h => h(App),
    mounted () {
        document.dispatchEvent(new Event('render-event'))
    }
}).$mount('#app')

4.修改路由模式

router.js 中设置mode: “history”

.......
let router = new Router({
    mode: 'history',  // 去掉路由地址的#
    routes: [
        {
            path: '/',
            name: '首页',
            component: Index
        },
........

5.打包部署

运行npm run build，看一下生成的 dist 的目录里是不是有每个路由名称对应的文件夹。然后找个 目录里 的 index.html 用IDE打开，看文件内容里是否有该文件应该有的内容。有的话，就设置成功了.然后即可将打包生成的文件部署至服务器即可。

扩展：

vue路由模式设置为history模式后，如果刷新会出现404的错误。

如果前端页面是单独部署的话，可设置服务器将404页面重定向至项目首页index.html。如果是和后端项目在一块部署的，可修改程序将404页面指向首页index.html，如果这种404错误的路由比较少的话，在后端项目中添加对应的路由指向首页也可以index.html。