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

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

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

需求場景

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

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

訪問的文件不存在，主要是因為路徑配置問題。
提示跨域問題，不支持files協(xié)議，主要是因為esModule問題。

問題1：訪問的文件不存在，主要是因為路徑配置問題。

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

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

驗證路徑是否正常看瀏覽器中的network看文件是否加載正常

問題2. 提示跨域問題，不支持files協(xié)議，主要是因為esModule問題

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

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

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

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

解決：將打包生成的文件改成為沒有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'], // 默認是modules,百度說是更改這個會去輸出兼容瀏覽器，嘗試沒啥作用，先配置吧
  }
 ....
})

step3:

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

import fs from 'fs';

console.time('轉(zhuǎn)換耗時');
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)換耗時');

step4:

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

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

在這里插入圖片描述

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