nuxt入门教程（一）vue如何实现全站静态化？

不知道你有没有发现，vue做的网站除了首页以外，其他页面根本就不能被百度收录。以至于有很多做seo的同事痛斥其种种不是，最后被强迫改为不分离开发。

至于vue的详情页为什么不能被百度收录，这就涉及到了spa的核心概念，因为数据都是异步获取来的，前端根本就没有所谓的纯静态一说。通俗点讲就是，页面都是js通过ajax获取到数据以后，动态生成的。既然它本来就没有一个文件放在服务器上，当然，爬虫也就不能获取到这个静态的url地址了。

但是url静态地址又是做seo必须的东西..

所以今天龙哥教你一套新的前端框架，基于vue的ssr前端框架—nuxt。本地开发的时候，使用vue语法，模块化你的项目，然后发布的时候生成静态，把ajax获取来的内容转化成静态html以利于seo。真正实现模块化和静态化两不误！

首先说明一下，龙哥本地的nuxt环境是2.8.1。如果你的版本号和我的不符，可能有部分语法你需要参考官方API开发手册。

使用命令：

小知识：啥是npx？

我们以前不是用的npm吗，但是这货每次安装东西的时候，你还得给全局装一个-g，相当于你电脑里老得有这个服务。

但其实你项目中已经包含了运行时候所需要得所有东西了。

如果你用了npx，他不会给你装这个东西，而是装得时候用一下，用完了就卸载，效率更高。

npx是nodejs在5.0版本以后新加入的，非常牛逼。

所以我们现在来cnpm -g 那一步都不需要了，我们直接npx创建项目即可！！！

直接输入

注意这里有可能报错，不用管他，过个几秒就安装好了。

还有一个需要注意的地方，你的git版本不能低于2.17否则后面有几个需要arrow选择得地方你可能选不了，请升级你的git版本。

然后就可以开始安装了。

等你看到这个界面，就是安装好了。

他会自动安装所需要得所有包，安装完了以后你进入localhost:3000

出现这个界面，就OK了

要开发 SEO 的静态网站，又想享受框架开发的舒适，于是选择 Nuxt，可用来生成静态站总还是有些蹩脚，比如默认不支持动态路由等。

这两个次版本的发布，终于让 Nuxt 开发静态网站方便多了！

先说亮眼新特性：

可以处理动态路由 和 nuxt start 真是太棒了。

target: 'static' + nuxt generate 生成的【完全静态】的应用又是什么意思呢？与之前 generate 生成的静态应用有什么区别？

我们先来看一下 Nuxt 官网的一张图，阐述了 Nuxt.js 应用一个完整的服务器请求到渲染（或用户通 <nuxt-link> 切换路由渲染页面）的流程

可以看到，在 SSR 中，服务端会执行 asyncData() 和 fetch() ，用来访问接口生成数据，从而在服务端就渲染出页面内容。

那么，在 generate 生成的静态应用中会怎样呢？如我们预料，生成的 dist 中的 html，就是执行过 asyncData() 和 fetch() 的有数据内容的文件了。

但是，当我们切换路由的时候，这两个函数又被调用了一遍，如果其中有接口调用，就会再次请求接口，拿回来最新的数据。问题是，这让页面切换变慢，而许多静态网站并不需要请求最新的数据。

于是，【完全静态】的应用就被千呼万唤召唤出来了，它的接口请求的数据定格在 generate 的时候，部署后不会再通过 asyncData() 和 fetch() 调用 API 了。这使得页面切换变得非常快。

可是，对于某些页面，我还想要最新的数据，怎么办呢？别担心，新版的 nuxt 还很贴心地支持了 Preview mode :

添加这个插件，然后在需要更新数据的页面 url 后面加上 ?preview=1 就可以做到了。

Going Full Static

NuxtJS 官方文档

   在项目中，有些功能是需要在登录后的场景下才可以使用的，所以我们需要通过 某个条件判断当前是否是登录状态，  校验登录态，一般通过判定vuex 或 cookie 或 storage中 是否存在用户信息 。常见方案如下：

a ) 登录成功后,用户信息存入storage中「可以是 localStorage 或 sessionStorage」

出现问题 : 在服务端渲染的时候「就是在asyncData中」 直接报错

原因 ：因为storage技术是浏览器端技术，node用不了，所以这个方案直接pass掉

b ) 登录成功后, 用户信息存入vuex 的store中

出现问题 : 刷新后数据丢失 

原因 : store里的数据是保存在运行内存中的,当页面刷新时，页面会重新加载vue实例，store里面的数据就会被重新赋值初始化

后续处理 ：一般针对vuex 刷新数据丢失问题，会去做vuex数据持久化，这里考虑到上述 在服务端渲染的无法使用客户端storage技术，所以vuex数据持久化操作 使用cookie去做 「为啥用cookie? 因为cookie 浏览器端和服务器端都可以用」

后续场景: 做完数据持久化后，再次刷新，登录态信息不会再丢失，可以正确显示 登录态相关的业务渲染逻辑。但是出现了一个新的问题，那就是

刷新的时候，判断登录态相关的渲染样式会出现闪烁，第一印象就是拿取用户信息做判断的时候，拿数据的速度慢了，是什么原因造成的呢?

应该也是在初始化的时候，服务端渲染引起的； 在服务端渲染的时候页面已经准备好展示的效果，并被浏览器展示 ， 当浏览器渲染前的一刹，又要获取vuex中的登录态进行判断展示，所以就有了一刹的卡顿。

 最终处理: 在做vuex数据持久话的时候，在nuxtServerInit 内处理

有的使用，我们可能需要去直接解析html字符串，vue提供了v-html   nuxt中 使用v-html ，一定要注意， 等待渲染的html字段串 完全遵守 w3c的html规范的。 例如<p>这样，如果没有</p>闭合， 页面会报错，打包后发布到线上环境，直接爆发阻塞性问题。

开发环境报错:

打包后部署线上报错:

nuxt 中， 无需去手动配置vue-router,他在业务中的目录就是一个默认路由，但是考虑到有一些项目可能路由比较复杂，就可能需要自定义的去配置路由。流程如下

    a .新建个路由文件

 b . 在nuxt.config.js 中配置

   引入自定义路由文件

   在modules字段同级别 加入 router字段配置

 

项目中,可能某一些模块需要登录后才能访问，比如个人中心.vue 传统的项目中，大多数是在路由守卫中做判断，判断登录的话继续访问，未登录跳转到登录页；那么在nuxt框架的项目中怎么样去实现这样功能呢?  

 这里需要用到nuxt 框架的中间件功能了，流程如下:

 a ) 在 nuxt框架的默认中间件目录 middleware 新建一鉴权文件

b ) 在nuxt.config.js 配置文件的 plugins属性 中引入这个文件

 c ) 在需要路由鉴权的 模块直接引用 ； 路由鉴权完成啦

  需要进行 seo 的页面，初始化渲染的数据 必须在 asyncData内 获取， 这样才会被nuxt 在服务端组装好 html,返回浏览器渲染， 其他vue生命周期内初始化的数据 ，不会在html 里展示。

 坑点:

   1. asyncData 内处理接口调试的问题。

   只能在node服务面板上看到

   2. 一旦接口报错； 页面直接挂掉

   处理方法:

   必须在接口处理之前 包含  try {} catch{}

   考虑错误处理的场景。 一般处理方式与两种

  a. 一种是 错误场景仍然返回 初始化数据 

b. 另一种直接返回错误页 ：利用nuxt内部提供的错误处理机制

nuxt会在默认的错误页做出相应的处理；至于这个错误页面，当然你自己准备啦

在开发过程中，常见的问题基本这些啦，如果还有新的问题，欢迎大家留言讨论，本人也是第一次使用nuxt框架做服务端渲染，欢迎指正，哈哈!

---