讀本文前，請(qǐng)先熟讀nuxt官方文檔，并且具備一定的vue.js相關(guān)開發(fā)經(jīng)驗(yàn)

中文文檔
英文文檔
vue SSR指南

一、CSR和SSR對(duì)比

在SPA之前的時(shí)代，我們傳統(tǒng)的Web架構(gòu)大都是SSR，如：Wordpress（PHP）、JSP技術(shù)、JavaWeb等這些程序都是傳統(tǒng)典型的SSR架構(gòu)，即：服務(wù)端取出數(shù)據(jù)和模板組合生成 html輸出給前端，前端發(fā)生請(qǐng)求時(shí)，重新向服務(wù)端請(qǐng)求html資源。

SPA（CSR）:

SPA應(yīng)用，到了Vue、React，單頁面應(yīng)用優(yōu)秀的用戶體驗(yàn)，逐漸成為了主流，頁面整體是javaScript渲染出來的，稱之為客戶端渲染CSR。SPA渲染過程。由客戶端訪問URL發(fā)送請(qǐng)求到服務(wù)端，返回HTML結(jié)構(gòu)（但是SPA的返回的HTML結(jié)構(gòu)是非常的小的，只有一個(gè)基本的結(jié)構(gòu)）?？蛻舳私邮盏椒祷亟Y(jié)果之后，在客戶端開始渲染HTML，渲染時(shí)執(zhí)行對(duì)應(yīng)javaScript，最后渲染template，渲染完成之后，再次向服務(wù)端發(fā)送數(shù)據(jù)請(qǐng)求，注意這里時(shí)數(shù)據(jù)請(qǐng)求，服務(wù)端返回json格式數(shù)據(jù)?？蛻舳私邮諗?shù)據(jù)，然后完成最終渲染。

CSR原理圖

CSR多數(shù)是基于webpack構(gòu)建的項(xiàng)目，編譯出來的html文件，資源文件都被打包到j(luò)s中，這樣的頁面是不利于搜索引擎優(yōu)化(SEO, Search Engine Optimization)，并且內(nèi)容到達(dá)時(shí)間(time-to-content) （或稱之為首屏渲染時(shí)長(zhǎng)）也有很大的優(yōu)化空間

簡(jiǎn)單來講，SPA雖然給服務(wù)器減輕了壓力，也存在比較明顯的兩個(gè)缺點(diǎn)：

• 首屏渲染時(shí)間比較長(zhǎng)：必須等待JavaScript加載完畢，并且執(zhí)行完畢，才能渲染出首屏。
• SEO不友好：爬蟲只能拿到一個(gè)div元素，認(rèn)為頁面是空的，不利于SEO。

什么是SEO呢？SEO即通過各種技術(shù)（手段）來確保，你的Web內(nèi)容被搜素引擎最大化收錄，最大化提高權(quán)重，帶來更多流量。大部分的搜索引擎僅能抓取URI直接輸出的數(shù)據(jù)資源，對(duì)于 Ajax 類的異步請(qǐng)求的數(shù)據(jù)無法抓取

因此，對(duì)于那些展示宣傳型頁面，如官網(wǎng)，必須進(jìn)行服務(wù)端渲染

SSR:

為了解決如上兩個(gè)問題，出現(xiàn)了SSR解決方案，后端渲染出首屏的DOM結(jié)構(gòu)返回，前端拿到內(nèi)容帶上首屏，后續(xù)的頁面操作，再用單頁面路由和渲染，稱之為服務(wù)端渲染(SSR)。

SSR渲染流程是這樣的，客戶端發(fā)送URL請(qǐng)求到服務(wù)端，在服務(wù)端做出html和數(shù)據(jù)的渲染，渲染完成之后返回html結(jié)構(gòu)，客戶端拿到頁面的html結(jié)構(gòu)渲染首屏。所以用戶在瀏覽首屏的時(shí)候速度會(huì)很快，因?yàn)榭蛻舳瞬恍枰俅伟l(fā)送ajax請(qǐng)求。并不是做了SSR我們的頁面就不屬于SPA應(yīng)用了，它仍然是一個(gè)獨(dú)立的spa應(yīng)用。

SSR原理圖

SSR是處于CSR與SPA應(yīng)用之間的一個(gè)折中的方案，在渲染首屏的時(shí)候在服務(wù)端做出了渲染，注意僅僅是首屏，其他頁面還是需要在客戶端渲染的，在服務(wù)端接收到請(qǐng)求之后并且渲染出首屏頁面，會(huì)攜帶著剩余的路由信息預(yù)留給客戶端去渲染其他路由的頁面。

vueSSR

將本來要放在瀏覽器執(zhí)行創(chuàng)建的組件，放到服務(wù)端先創(chuàng)建好，然后生成對(duì)應(yīng)的html將它們直接發(fā)送到瀏覽器，最后將這些靜態(tài)標(biāo)記"激活"為客戶端上完全可交互的應(yīng)用程序。

在瀏覽器第一次訪問某個(gè)URI資源的時(shí)候（首屏），Web服務(wù)器根據(jù)路由拿到對(duì)應(yīng)數(shù)據(jù)渲染并輸出，且輸出的數(shù)據(jù)中包含兩部分：

• 路由頁對(duì)應(yīng)的頁面及已渲染好的數(shù)據(jù)
• 完整的SPA程序代碼

在首屏渲染完成之后，此時(shí)我們看到的其實(shí)已經(jīng)是一個(gè)和之前的SPA相差無幾的應(yīng)用程序了，接下來我們進(jìn)行的任何操作都只是客戶端的應(yīng)用進(jìn)行交互，頁面/組件由Web端渲染，路由也由瀏覽器控制，用戶只需要和當(dāng)前瀏覽器內(nèi)的應(yīng)用打交道就可以了。

vueSSR原理圖

webpack將 Source 打包出兩個(gè)bundle文件：其中 Server Bundle用于服務(wù)端渲染，服務(wù)端通過渲染器 bundleRenderer 將 bundle 生成首屏html片段；而 Client Bundle 用于客戶端渲染，首屏外的交互和數(shù)據(jù)處理還是需要瀏覽器執(zhí)行 Client Bundle 來完成

缺點(diǎn)：

• 開發(fā)條件所限。瀏覽器特定的代碼，只能在某些生命周期鉤子函數(shù)(lifecycle hook)中使用；一些外部擴(kuò)展庫(external library)可能需要特殊處理，才能在服務(wù)器渲染應(yīng)用程序中運(yùn)行。
• 更多的服務(wù)器端負(fù)載。在 Node.js 中渲染完整的應(yīng)用程序，顯然會(huì)比僅僅提供靜態(tài)文件的 server 更加大量占用 CPU 資源，因此如果你預(yù)料在高流量環(huán)境(high traffic)下使用，請(qǐng)準(zhǔn)備相應(yīng)的服務(wù)器負(fù)載，并明智地采用緩存策略。

二、nuxt.js介紹

1. nuxt.js是什么？

Nuxt.js 是vue官方推薦的一個(gè)基于 Vue.js的做Vue SSR的通用應(yīng)用框架（開箱即用），集成了Vue，Vue-Router，Vuex，Vue-Meta等組件/框架，內(nèi)置了webpack用于自動(dòng)化構(gòu)建，使我們可以更快速地搭建一個(gè)具有服務(wù)端渲染能力的應(yīng)用。

2. nuxt.js的優(yōu)勢(shì)？

作為框架，Nuxt.js 為 客戶端/服務(wù)端 這種典型的應(yīng)用架構(gòu)模式提供了許多有用的特性，例如異步數(shù)據(jù)加載、中間件支持、布局支持等。Nuxt.js 有以下比較明顯的特性

• 支持各種樣式預(yù)編譯器SASS，LESS等等
• 本地開發(fā)支持熱加載
• HTML頭部標(biāo)簽管理（依賴vue-meta實(shí)現(xiàn)）
• 自動(dòng)代碼分層
• 強(qiáng)大的路由功能，支持異步數(shù)據(jù)（路由無需額外配置）
• 內(nèi)置 webpack 配置，無需額外配置

3. nuxt.js的使用

npm create nuxt-app <project-name>

4. nuxt.js目錄結(jié)構(gòu)

（layouts、pages、static、store、nuxt.config.js、package.json）是Nuxt保留的，不可以更改

5. nuxt.js渲染流程

• Incoming Request指的是瀏覽器發(fā)出一個(gè)請(qǐng)求，服務(wù)端接收請(qǐng)求后
• 要檢查當(dāng)前有沒有nuxtServerInit這個(gè)配置項(xiàng)，如果有的話就先執(zhí)行這個(gè)函數(shù)。具體的作用和使用可參考官方文檔nuxtserverinit-方法
• middleware中間件，中間件允許您定義一個(gè)自定義函數(shù)運(yùn)行在一個(gè)頁面或一組頁面渲染之前。也就是可以在 匹配布局（layout 組件）前執(zhí)行某種操作，也可以在解析完 layout 之后，解析 page 組件前 執(zhí)行某種操作?？梢岳斫鉃槭锹酚善鞯臄r截器的作用
• 驗(yàn)證：validate()，可以配合高級(jí)動(dòng)態(tài)路由去做驗(yàn)證。如果校驗(yàn)不通過，Nuxt.js 將自動(dòng)加載顯示 404 錯(cuò)誤頁面或 500 錯(cuò)誤頁面，或者進(jìn)行重定向。
• 獲取數(shù)據(jù)，asyncData方法獲取數(shù)據(jù)并返回給當(dāng)前組件，fetch方法修改vuex的store
• render：最后進(jìn)行渲染。將渲染后的頁面返回給瀏覽器，用戶在頁面進(jìn)行操作，如果再次請(qǐng)求新的頁面，此時(shí)只會(huì)回到生命周期中的 middlerware 中，而非 nuxtServerInit。
• nuxt-link，如果是發(fā)起一個(gè)新的路由，那么這個(gè)時(shí)候要從頭開始循環(huán)

我們把服務(wù)器端創(chuàng)建的 .vue 文件全部理解成組件，在服務(wù)器端環(huán)境（node）通過 beforeCreate 和 created 這倆個(gè)生命周期節(jié)點(diǎn)后服務(wù)器端 vue 組件生命周期結(jié)束。返回頁面給瀏覽器，在客戶端環(huán)境（v8）中這個(gè) vue 組件實(shí)例創(chuàng)建后會(huì)在客戶端再次擁有生命周期，此時(shí)生命周期中有 mounted 等鉤子函數(shù)。

需要特別注意的是 nuxt 中沒有 mounted 鉤子函數(shù)也沒有組件實(shí)例，只有 beforeCreate/created 鉤子與 context 對(duì)象。beforeCreated()和created()這兩個(gè)生命周期函數(shù)是同時(shí)運(yùn)行在服務(wù)端&&客戶端，vue的其他鉤子則運(yùn)行在客戶端，所以beforeCreated()和created()不存在window對(duì)象

三、nuxt.js渲染過程部分詳解

1、nuxtServerInit

舉例：打開網(wǎng)頁要立即顯示的內(nèi)容

// SSR方式：
// 1、nuxtServerInit 方法

actions: {
  async nuxtServerInit({commit},{req,app}) {
    let {data: {province, city}} = await axios.get('/aa/bb')
    commit('home/setPosition',{province: '', city: ''})
  }
}

// 2、middleware 屬性

middleware: async (ctx) => {
  let {data: {province, city}} = await axios.get('/aa/bb')
}

// NO-SSR
vue 組件 mounted 函數(shù)發(fā)送請(qǐng)求

2、異步數(shù)據(jù) asyncData

asyncData方法會(huì)在組件（限于頁面組件）每次加載渲染之前，即在服務(wù)端或路由更新之前被調(diào)用。在 asyncData() 中可以處理請(qǐng)求得來的數(shù)據(jù)，通過 return 將處理后的數(shù)據(jù)返回給當(dāng)前 vue 組件的 data 。再次強(qiáng)調(diào)這里不能使用 this ，因?yàn)闆]有組件實(shí)例，asyncData() 默認(rèn)的參數(shù)是 ctx 即 content 對(duì)象。

該方法用來獲取數(shù)據(jù)，在服務(wù)器端把異步獲取到的數(shù)據(jù)扔給瀏覽器，那是如何拋給瀏覽器的呢？

通過下發(fā)一個(gè)`script`標(biāo)簽，然后在`window`上掛了一個(gè)對(duì)象這個(gè)對(duì)象，第一個(gè)是告訴你用的是哪個(gè)模板，第二個(gè)給你的是數(shù)據(jù)

3、布局

Nuxt.js布局方式如下圖所示：

nuxt.js實(shí)現(xiàn)了一個(gè)新的概念，layout布局，我們可以通過layout布 局方便的實(shí)現(xiàn)頁面的多個(gè)布局之間方便的切換。具體開發(fā)的頁面中，如果使用默認(rèn)布局，則不需指定頁面的布局，nuxt框架會(huì)自動(dòng)對(duì)沒有指定布局的頁面和default布局進(jìn)行關(guān)聯(lián)。如果需要指定布局，則在layout字段中對(duì)布局進(jìn)行指定。

<script>
export default {
 layout: 'plusBuy',
 ...
}
</script>

// 如果layout文件中建立了一個(gè)單獨(dú)的文件，則在使用中也要指定
<script>
export default {
 layout: 'plusBuy/plusBuy',
 ...
}
</script>

四、nuxt爬坑

1、localhost訪問可以，換成真實(shí)的ip地址后訪問不了

解決方案：

1. 確認(rèn)有沒有開代理
2. 在package.json里做如下配置

"config": {
  "nuxt": {
    "host": "0.0.0.0",
    "port": 3000
  }
}

2、接口跨域問題

解決方案

• 安裝@nuxtjs/axios、@nuxtjs/proxy
• 在nuxt.config.js做如下配置

modules: ['@nuxtjs/axios'], // 不需要加入@nuxtjs/proxy

axios: {
  proxy: true
},
proxy: {
  '/wlfrontend': { // 請(qǐng)求到 /wlfrontend 代理到請(qǐng)求 http://10.102.140.38:7001/wlfrontend
    target: 'http://10.102.140.38:7001',
    changeOrigin: true // 如果接口跨域，需要進(jìn)行這個(gè)參數(shù)配置
  },
  '/scenery': { // 將'localhost:8080/scenery/xxx'代理到'https://m.ly.com/scenery/xxx'
    target: 'https://m.ly.com', // 代理地址
    changeOrigin: true, // 如果接口跨域，需要進(jìn)行這個(gè)參數(shù)配置
    secure: false // 默認(rèn)情況下，不接受運(yùn)行在 HTTPS 上，且使用了無效證書的后端服務(wù)器。如果你想要接受，只要設(shè)置 secure: false
  }
}

3、asyncDate fetch created 因?yàn)榉?wù)端客戶端都會(huì)走，如果不想在客戶端執(zhí)行？

async asyncData ({ query, store, req }) {
  if (!process.server) return
}

async fetch({ store, params }){
  if (!process.server) return
}

created(){
  if (!process.server) return
},

4、頁面做緩存，也就是返回上一級(jí)保持?jǐn)?shù)據(jù)不重新請(qǐng)求

解決方案:
在布局頁面處理，layout/default.vue或者是自己建立的布局頁面

<template>
  <div class="plusBuy">
    <nuxt keep-alive />
  </div>
</template>

5、nuxt是把所有頁面的js都引入到主頁了？

在生產(chǎn)模式下，Nuxt.js 使用瀏覽器的預(yù)加載策略來預(yù)加載目標(biāo)頁面的腳本資源。所以當(dāng)用戶點(diǎn)擊某個(gè)鏈接時(shí)，會(huì)有一種秒開的感覺。預(yù)加載策略使得 Nuxt.js 既可以保持代碼分離又能保證頁面訪問體驗(yàn)。
<nuxt-link>則是幫我們擴(kuò)展了自動(dòng)預(yù)獲取代碼分割頁面?？梢允褂?no-prefetch屬性 禁用
如果想要禁用，在nuxt.config.js做如下配置

router: {
  prefetchLinks: false, // 全局禁用所有鏈接上的預(yù)取
}
render: {
  resourceHints: false, // 添加prefetch和preload，以加快初始化頁面加載時(shí)間。如果有許多頁面和路由，可禁用此項(xiàng)
},

6、切換子路由的head中外部引入腳本載入有延遲，所以在調(diào)用時(shí)報(bào)錯(cuò)

注意：
1、引入腳本不要加async:true，這樣的話腳本不會(huì)阻塞，在下面代碼有用到該腳本中的方式時(shí)，腳本可能還沒有加載完
2、需要每個(gè)小項(xiàng)目自己做個(gè)定制化頁面layout，layout/我的目錄/我的頁面.vue 然后在定制化頁面中使用head()加入腳本

export default {
  // 方式一：
  head: {
    script: [
      { type: 'text/javascript', src: 'https://js.40017.cn/cn/min/??/touch/hb/c/bridge.2.1.4.js?v=2016053', defer: true }
    ]
  }
  // 方式二：
  head () {
    return {
      script: [
        { type: 'text/javascript', src: 'https://js.40017.cn/cn/min/??/touch/hb/c/bridge.2.1.4.js?v=2016053', defer: true }
      ]
    }
  }
}

7、滾動(dòng)事件

如果html和body設(shè)置了100%，那么子頁面足夠長(zhǎng)時(shí)滾動(dòng)的話，滾動(dòng)事件要綁定在子頁面上，因?yàn)?code>body的高度不是整個(gè)頁面的高度

// 1. 在子頁面父元素加
<template>
  <div class="plus" ref="mainPage"></div>
</template>

// 2. 樣式設(shè)置100%滾動(dòng)
.plus {
  height: 100%;
  overflow-y: scroll;
  -webkit-overflow-scrolling : touch;
}

// 3. 再添加滾動(dòng)事件
function scrollEvent() {
  var that = this;
  let dom = this.$refs.mainPage;

  dom.onscroll = function() {
    let wh = dom.scrollTop;
    // 頁面上滑，出現(xiàn)
    wh > 100 ? (that.showBackTop = true) : (that.showBackTop = false);
    // 未開通，頁面滑動(dòng)至不出現(xiàn)頂部的立即開通按鈕時(shí)，底部的立即開通固定展示
    if(that.memberRightsInfo && !that.memberRightsInfo.IsPlusMember){
      if(document.querySelector('.tab') && document.querySelector('.tab').offsetTop){
        let distance = document.querySelector('.tab').offsetTop;
        wh > distance - 50 ? (that.isShowFixedBtn = true) : (that.isShowFixedBtn = false);
      }
    }
  };
}

8、文件下建立了其他文件，比如store/plusBuy/index.js，并沒有在store下直接建立index.js，如何使用？

原理：Nuxt把store中的index.js文件中所有的state、mutations、actions、getters都作為其公共屬性掛載到了store實(shí)例上，然而其他的文件則是使用的是命名空間，其對(duì)應(yīng)的命名空間的名字就是其文件名。

computed: {
  ...mapState('plusBuy', {
    nickName: state => state.nickName
  })
}

...mapMutations('plusBuy', {
  setCityId: 'setCityId' // 將 `this.setCityId()` 映射為 `this.$store.commit('setCityId')`
})

...mapActions('plusBuy', {
  login: 'login' // 將 `this.login()` 映射為 `this.$store.dispatch('login')`
})

9、asyncData不可以調(diào)用this，如果有好多個(gè)異步或數(shù)據(jù)進(jìn)行處理，如何優(yōu)化asyncData()

// 可以使用類
class A {
  aatest(aa){
    console.log(aa)
  }
}

// 調(diào)用方法
async asyncData ({ query, store, req }) {
  var test = new A();
  test.aatest(123);
}

10、如何獲取cookie

// 服務(wù)端獲取cookie
b_getToken(req = {},c_name){
  if (req.headers && req.headers.cookie) {
    var req_Cookies = req.headers.cookie.split("; ")
    let tokens = ''
    req_Cookies.forEach(v => {
      if (v.indexOf(c_name + "=")>=0) {
        tokens = v
      }
    })
    return tokens.split('=')[1]
  } else {
    return ''
  }
}

// 客戶端獲取cookie
getCookie: function(c_name) {
  if (document.cookie.length > 0) {
    //先查詢cookie是否為空，為空就return ""
    let c_start = document.cookie.indexOf(c_name + "=") || ''; //通過String對(duì)象的indexOf()來檢查這個(gè)cookie是否存在，不存在就為 -1
    if (c_start != -1) {
      c_start = c_start + c_name.length + 1; //最后這個(gè)+1其實(shí)就是表示"="號(hào)啦，這樣就獲取到了cookie值的開始位置
      let c_end = document.cookie.indexOf(";", c_start); // 為了得到值的結(jié)束位置。因?yàn)樾枰紤]是否是最后一項(xiàng)，所以通過";"號(hào)是否存在來判斷
      if (c_end == -1) {
        c_end = document.cookie.length;
      }
      return unescape(document.cookie.substring(c_start, c_end)); 
    }
  }
  return "";
},

// 調(diào)用
let token = '';
if(process.server){
  token = serverUtilsFn.b_getToken(req,'17uCNRefId');
  console.log('server:' + token)
}else {
  token = utilsFn.getCookie('17uCNRefId');
  console.log('client:' + token)
}

11、axios數(shù)據(jù)處理問題，重復(fù)問題

import axios from 'axios';
import requestCheck from './requestCheck';

// 確保使用 axios.create創(chuàng)建實(shí)例后再使用。否則多次刷新頁面請(qǐng)求服務(wù)器，服務(wù)端渲染會(huì)重復(fù)添加攔截器，導(dǎo)致數(shù)據(jù)處理錯(cuò)誤
const myaxios = axios.create()

// axios.defaults.baseURL = "http://localhost:3000/"

myaxios.interceptors.request.use(config => {
  let req = {...config };
  req.url = req.method.toLocaleLowerCase() == 'post' ? requestCheck(req.url, req.data) : requestCheck(req.url, req.params);
  return req;

}, error => {
  return Promise.reject(error)
})

myaxios.interceptors.response.use(response => {
  return response
}, error => {
  return Promise.reject(error)
})

export default myaxios;

12、跳轉(zhuǎn)路由傳遞參數(shù)并且取值

傳遞參數(shù) -- this.$router.push({name: ' 路由的name ', params: {key: value}})
參數(shù)取值 -- this.$route.params.key
注: 使用這種方式，參數(shù)不會(huì)拼接在路由后面，地址欄上看不到參數(shù)
注意: 由于動(dòng)態(tài)路由也是傳遞params的，所以在 this.$router.push() 方法中 path不能和params一起使用，否則params將無效。需要用name來指定頁面。

13、設(shè)置頁面動(dòng)畫效果

/* 全局過渡動(dòng)效設(shè)置 - 淡出 (fade) 效果*/

.page-enter-active,
.page-leave-active {
  transition: opacity .5s;
}

.page-enter,
.page-leave-active {
  opacity: 0;
}

/* 局部過渡動(dòng)效設(shè)置 - 淡出 (fade) 效果*/

.test-enter-active,
.test-leave-active {
  transition: opacity .5s;
}

.test-enter,
.test-leave-active {
  opacity: 0;
}

// 在要使用的組件頁面中
export default {
  transition: 'test',
}

14、如何使用插件

// 1. 安裝插件
yarn add swiper -D

// 2. 引入
<script>
import Swiper from 'swiper'
</script>

// 3. 引入樣式
<style lang="less" scoped>
  @import "../../node_modules/swiper/css/swiper.css";
</style>

15、如何在組件中使用異步數(shù)據(jù)

如果組件不是和路由綁定的頁面組件，原則上是不可以使用異步數(shù)據(jù)的。因?yàn)?Nuxt.js 僅僅擴(kuò)展增強(qiáng)了頁面組件的data方法，使得其可以支持異步數(shù)據(jù)處理。

對(duì)于非頁面組件，有兩種方式可以實(shí)現(xiàn)數(shù)據(jù)的異步獲?。?/p>

1. 在組件的mounted方法里面實(shí)現(xiàn)異步獲取數(shù)據(jù)的邏輯，之后設(shè)置組件的數(shù)據(jù)，限制是：不支持服務(wù)端渲染。
2. 在頁面組件的asyncData或fetch方法中進(jìn)行API調(diào)用，并將數(shù)據(jù)作為props傳遞給子組件。服務(wù)器渲染工作正常。缺點(diǎn)：asyncData或頁面提取可能不太可讀，因?yàn)樗诩虞d其他組件的數(shù)據(jù)。

總之，使用哪種方法取決于你的應(yīng)用是否需要支持子組件的服務(wù)端渲染。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。