vite2.0 踩坑實(shí)錄

目錄

算是對上一篇的補充，記錄了一些在配置項目中遇到的問(wèn)題，希望對大家能有所幫助～

vite項目構建優(yōu)化

路由動(dòng)態(tài)導入 經(jīng)過(guò)rollup的構建，動(dòng)態(tài)導入的文件將會(huì )生成異步的chunk文件，在我們訪(fǎng)問(wèn)項目的時(shí)候按需加載，極大的提升應用的加載速度

import Home from '@/views/home/index.vue'
import Layout from '@/components/Layout.vue'

const routes: Array<RouteRecordRaw> = [
  {
    path: '/',
    component: Layout,
    redirect: '/home',
    children: [
      {
        path: '/home',
        name: 'Home',
        component: Home,
        meta: { title: '首頁(yè)' }
      },
      {
        path: '/about',
        name: 'About',
        meta: { title: '關(guān)于', keepAlive: true },
        component: () => import('@/views/about/index.vue')
      },
      {
        path: '/square',
        name: 'Square',
        meta: { title: '組件廣場(chǎng)', keepAlive: true },
        component: () => import('@/views/square/index.vue')
      }
    ]
  }
]
const router = createRouter({
  history: process.env.NODE_ENV === 'development'
    ? createWebHistory(process.env.BASE_URL)
    : createWebHashHistory(process.env.BASE_URL),
  routes,
    scrollBehavior(to, from, savedPosition) {
      if (savedPosition) {
        // 通過(guò)前進(jìn)后臺時(shí)才觸發(fā)
        return savedPosition
      } else {
        return { top: 0, behavior: 'smooth' }
      }
    }
  })

router.beforeEach((to, from, next) => {
  // 可以對權限進(jìn)行一些校驗
  if (to.path !== from.path) {
    document.title = `星樂(lè )圈 | ${to.meta.title}`
  }
  next()
})

router.onError((error) => {
  const pattern = /Loading chunk (\d)+ failed/g
  const isChunkLoadFailed = error.message.match(pattern)
  if (isChunkLoadFailed) {
    location.reload()
  }
})

export default router

上述代碼，是一個(gè)vite構建的vue項目的router文件，使用的vue-router@4.0.6,Vue Router支持開(kāi)箱即用的動(dòng)態(tài)導入，這意味著(zhù)你可以用動(dòng)態(tài)導入代替靜態(tài)導入.在代碼中可以看到：about頁(yè)和square頁(yè)都是動(dòng)態(tài)導入的。

關(guān)于動(dòng)態(tài)導入，MDN上有非常詳細的介紹:

經(jīng)過(guò)rollup的構建，動(dòng)態(tài)導入的文件將會(huì )生成異步的chunk文件，在我們訪(fǎng)問(wèn)項目的時(shí)候按需加載，極大的提升應用的加載速度。

在vite項目中的路由動(dòng)態(tài)導入中我踩的坑：

構建時(shí)不支持@/別名。在構建的時(shí)候，rollup構建時(shí)并不能按照配置的別名找到對應的文件，因此在構建環(huán)節會(huì )有報錯

解決方案：

• 一開(kāi)始感覺(jué)是引用路徑的問(wèn)題，所以嘗試了幾種引用方式,然后終于有一種成功了！component: () => import('/src/views/about/index.vue') 改成絕對路徑以后，就可以正常啟動(dòng)
• 升級vite版本，一開(kāi)始是vite@2.0.0-beta.35，不支持別名。在升級到vite@2.3.8之后就支持了。估計是2.0剛出，一下子沒(méi)有寫(xiě)完善也是可以理解滴～
• 使用import.meta.glob方法
  

我配置使遇到的一些報錯和警告

warning: "import.meta" is not available in the configured target environment ("es2019") and will be empty

當vite配置項esbuild.target 為 ‘es2019‘的時(shí)候，會(huì )有這個(gè)警告。表示這個(gè)情況下不支持使用import.meta api

[vite] Internal server error: Invalid glob import syntax: pattern must start with "." or "/" (relative to project root)

import.meta.glob() 中的參數必須以"." 或 "/" 開(kāi)頭，相對根目錄進(jìn)行匹配

最終的寫(xiě)法部分代碼：

  import Layout from '@/components/Layout.vue'

  const modules = import.meta.glob('/src/views/*/index.vue')

  const routes: Array<RouteRecordRaw> = [
    {
      path: '/',
      component: Layout,
      redirect: '/home',
      children: [
        {
          path: '/home',
          name: 'Home',
          component: modules['/src/views/home/index.vue'],
          meta: { title: '首頁(yè)' }
        },
        {
          path: '/about',
          name: 'About',
          meta: { title: '關(guān)于', keepAlive: true },
          component: modules['/src/views/about/index.vue']
        },
        {
          path: '/square',
          name: 'Square',
          meta: { title: '組件廣場(chǎng)', keepAlive: true },
          component: modules['/src/views/square/index.vue']
        }
      ]
    }
  ]

通過(guò)使用import.meta.glob 方法，我們可以通過(guò)后臺接口來(lái)配置路由，可控的進(jìn)行權限控制。routes數據如果由接口返回，則不在權限范圍內的組件根本不會(huì )生成路由項，這無(wú)疑增加了權限控制的力度。

配置build.rollupOptions.manualChunks，對node_modules文件進(jìn)行分包加載

manualChunks(id) {
  if (id.includes('node_modules') && id.includes('prime')) {
    return 'prime'
  } else if (id.includes('node_modules') && id.includes('vue')) {
    return 'vue'
  } else if (id.includes('node_modules')) {
    return 'vendor'
  }
}

如果不配置這項，vite會(huì )將node_modules包打包成一個(gè)大的異步vendor.js文件, 如果文件過(guò)大，這無(wú)疑增加了頁(yè)面渲染時(shí)的阻塞時(shí)長(cháng)。而且不利于頁(yè)面緩存優(yōu)化。
在上面的配置中，我將ui框架（primeVue）、vue相關(guān)的包分別打包成一個(gè)文件，這樣做除了可以減少每個(gè)依賴(lài)文件的體積之外，還可以對項目的緩存進(jìn)行優(yōu)化。這些基礎庫之類(lèi)的依賴(lài)包，更新的次數會(huì )比較少。
結合服務(wù)端的文件緩存策略配置，用戶(hù)除了首次訪(fǎng)問(wèn)時(shí)需要加載這些依賴(lài)文件，后面再訪(fǎng)問(wèn)，都可以直接從緩存讀取。將依賴(lài)文件代碼進(jìn)行一定的切割，可以極大的提升項目的性能。

而且，vite在構建的時(shí)候，會(huì )自動(dòng)生成如下html文件

  <!DOCTYPE html>
  <html lang="en">
    <head>
      <meta charset="UTF-8" />
      <link rel="icon" href="/favicon.ico" rel="external nofollow"  />
      <meta name="viewport" content="width=device-width, initial-scale=1.0" />
      <title>我的項目</title>
    <script type="module" crossorigin src="/assets/index.e3627129.js"></script>
    <link rel="modulepreload" href="/js/vue/vue.a1ee204f.js" rel="external nofollow" >
    <link rel="modulepreload" href="/js/prime/prime.eb4bfea6.js" rel="external nofollow" >
    <link rel="stylesheet" href="/assets/prime.296674d4.css" rel="external nofollow" >
    <link rel="stylesheet" href="/assets/index.289426b3.css" rel="external nofollow" >
  </head>
    <body>
      <div id="app"></div>
      
    </body>
  </html>

其中加了rel="modulepreload"屬性的link標簽，可以預加載原生模塊，保證某些文件可以不必等到執行時(shí)才加載，同樣可以提升頁(yè)面的性能

圖片資源文件處理。資源體積小于 assetsInlineLimit 選項值 則會(huì )被內聯(lián)為 base64 data URL，一起被打包至引用它的文件中。以此減少對文件的請求次數，提升項目性能

其它

給動(dòng)態(tài)導入文件生成的異步chunk，放置相對應的文件夾中，或者自定義給chunk命名。

嘿嘿，查了rollup文檔很久，又自己試了好一會(huì )兒，終于成功了。參考如下配置：

export default defineConfig({
  build: {
    assetsDir: 'assets',
    rollupOptions: {
      output: {
        // eslint-disable-next-line @typescript-eslint/no-explicit-any
        chunkFileNames: (chunkInfo: any) => {
          const facadeModuleId = chunkInfo.facadeModuleId ? chunkInfo.facadeModuleId.split('/') : []
          const fileName = facadeModuleId[facadeModuleId.length - 2] || '[name]'
          return `js/${fileName}/[name].[hash].js`
        },
      }
    }
  }
})

vite配置傳入全局的scss變量

配置如下

export default defineConfig({
  css: {
    preprocessorOptions: {
      scss: {
        additionalData: '@import "./src/styles/variables";'
      }
    }
  },
})

還需要注意的是，不同版本的vite之間，配置項會(huì )存在一些差異，所以在對項目進(jìn)行配置的時(shí)候，如果你完全按照文檔進(jìn)行配置還是有問(wèn)題，不妨看看是不是自己的版本與文檔的版本不一樣導致的。

最后

分享一下我配置好了的vite2.0+Vue3.0項目：, 用來(lái)試水的項目，如果有什么不對的地方，歡迎指正！ 

到此這篇關(guān)于vite2.0 踩坑實(shí)錄的文章就介紹到這了,更多相關(guān)vite2.0 踩坑內容請搜索腳本之家以前的文章或繼續瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！