快捷導(dǎo)航

vite打包靜態(tài)文件打開(kāi)顯示空白的解決

更新時(shí)間：2023年02月01日 10:54:05 作者：笨鐘

本文主要介紹了vite打包靜態(tài)文件打開(kāi)顯示空白的解決，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

需求場(chǎng)景

本地調(diào)試訪問(wèn)打包的文件看是否有啥問(wèn)題，方便定位線上問(wèn)題
安卓手機(jī)需要去直接訪問(wèn)靜態(tài)文件，而不是訪問(wèn)域名的情況

vite 打包生成的文件如果直接放在服務(wù)器中是可以正常訪問(wèn)的，但是本地直接訪問(wèn)打包生成index.html文件就會(huì)提示以下問(wèn)題。

訪問(wèn)的文件不存在，主要是因?yàn)槁窂脚渲脝?wèn)題。
提示跨域問(wèn)題，不支持files協(xié)議，主要是因?yàn)閑sModule問(wèn)題。

問(wèn)題1：訪問(wèn)的文件不存在，主要是因?yàn)槁窂脚渲脝?wèn)題。

解決：在 vite.config.js文件中配置

export default defineConfig({
	...
   base: "./", 
    ...
  })

驗(yàn)證路徑是否正常看瀏覽器中的network看文件是否加載正常

問(wèn)題2. 提示跨域問(wèn)題，不支持files協(xié)議，主要是因?yàn)閑sModule問(wèn)題

對(duì)比webpack 打包靜態(tài)文件是否可以正常訪問(wèn)

答案：正常
在vue.config.js 文件中配置

module.exports = {
  outputDir: 'dist',
  publicPath: baseUrl,

原理：開(kāi)始通過(guò)file協(xié)議直接訪問(wèn)index.html，在index.html中靜態(tài)引入index.js，在index.js中import test.js。在import的過(guò)程中需要http服務(wù)器去解析es6語(yǔ)法并添加header頭信息去跨域引入test.js，但是file協(xié)議相當(dāng)于通過(guò)資源管理器靜態(tài)訪問(wèn)index.html，中間的過(guò)程沒(méi)有http服務(wù)器參與解析，所以無(wú)法識(shí)別es6的import語(yǔ)法。

解決：將打包生成的文件改成為沒(méi)有moudle的文件

step1：安裝

$ npm install @vitejs/plugin-legacy

step2: 配置vite.config.js

import legacy from '@vitejs/plugin-legacy';
export default defineConfig({
....
  plugins: [legacy({
    targets: ['defaults', 'not IE 11']
  }),vue()],
   build:{
    target: ['es2015', 'chrome63'], // 默認(rèn)是modules,百度說(shuō)是更改這個(gè)會(huì)去輸出兼容瀏覽器，嘗試沒(méi)啥作用，先配置吧
  }
 ....
})

step3:

在dist并列的文件夾中創(chuàng)建腳本文件 (用于替換module等關(guān)鍵詞，省的每次得手動(dòng)刪除)toFile.cjs
創(chuàng)建 toFiles.cjs (為啥格式不是js為了執(zhí)行命令不報(bào)兼容的錯(cuò)誤)

import fs from 'fs';

console.time('轉(zhuǎn)換耗時(shí)');
const distPath = './dist/index.html';//打包路徑的index.html
let htmlText = fs.readFileSync(distPath, 'utf8');
let resultText = '';
let htmlArr = htmlText.match(/.*\n/g) || [];
htmlArr.forEach(str => {
    str = str.replace(/\s?nomodule\s?/g,' ');
    str = str.replace(/\s?crossorigin\s?/g,' ');
    str = str.replace(/data-src/g,'src');
    if(!/type="module"/i.test(str)) resultText += str;
});
fs.writeFileSync(distPath,resultText,'utf8');
console.timeEnd('轉(zhuǎn)換耗時(shí)');

step4:

npm install fs // 安裝fs
node toFile.cjs  // 執(zhí)行腳本

step5: 查看 dist 文件夾中的 index.html 文件,查看是否沒(méi)有module 、 crossorigin 等關(guān)鍵詞，訪問(wèn)index.html 文件查看效果

在這里插入圖片描述

一般執(zhí)行到這里基本是可以正常訪問(wèn)的，但是我的項(xiàng)目還是空白，后面觀察加載的html結(jié)構(gòu)發(fā)現(xiàn)router-view的組件沒(méi)有加載上去，后面嘗試將router.js 文件中history模式改成了hash，然后再重新打包執(zhí)行上面的操作能夠正常打開(kāi)。

總結(jié)：

vite生成的文件會(huì)帶有module，導(dǎo)致存在跨域問(wèn)題，大多數(shù)項(xiàng)目開(kāi)發(fā)都是將文件放在服務(wù)器中通過(guò)域名去訪問(wèn)，但是特殊情況需要直接訪問(wèn)靜態(tài)資源。所以要去解決file存在跨域的問(wèn)題。