vite打包靜態(tài)文件打開顯示空白的解決
需求場(chǎng)景
- 本地調(diào)試訪問打包的文件看是否有啥問題,方便定位線上問題
- 安卓手機(jī)需要去直接訪問靜態(tài)文件,而不是訪問域名的情況
vite 打包生成的文件如果直接放在服務(wù)器中是可以正常訪問的,但是本地直接訪問打包生成index.html
文件就會(huì)提示以下問題。
- 訪問的文件不存在,主要是因?yàn)槁窂脚渲脝栴}。
- 提示跨域問題,不支持files協(xié)議,主要是因?yàn)閑sModule問題。
問題1:訪問的文件不存在,主要是因?yàn)槁窂脚渲脝栴}。
解決:在 vite.config.js
文件中配置
export default defineConfig({ ... base: "./", ... })
驗(yàn)證路徑是否正??礊g覽器中的network看文件是否加載正常
問題2. 提示跨域問題,不支持files協(xié)議,主要是因?yàn)閑sModule問題
對(duì)比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服務(wù)器去解析es6語法并添加header頭信息去跨域引入test.js,但是file協(xié)議相當(dāng)于通過資源管理器靜態(tài)訪問index.html,中間的過程沒有http服務(wù)器參與解析,所以無法識(shí)別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'], // 默認(rèn)是modules,百度說是更改這個(gè)會(huì)去輸出兼容瀏覽器,嘗試沒啥作用,先配置吧 } .... })
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
文件,查看是否沒有module 、 crossorigin 等關(guān)鍵詞,訪問index.html
文件 查看效果
一般執(zhí)行到這里基本是可以正常訪問的,但是我的項(xiàng)目還是空白,后面觀察加載的html結(jié)構(gòu)發(fā)現(xiàn)router-view的組件沒有加載上去,后面嘗試將router.js 文件中history模式改成了hash,然后再重新打包執(zhí)行上面的操作能夠正常打開。
總結(jié):
vite生成的文件會(huì)帶有module,導(dǎo)致存在跨域問題,大多數(shù)項(xiàng)目開發(fā)都是將文件放在服務(wù)器中通過域名去訪問,但是特殊情況需要直接訪問靜態(tài)資源。所以要去解決file存在跨域的問題。
反思:
- webpack為啥打包出的文件同樣是file直接訪問但是不存在跨域。
- webpack為啥打包出的文件不帶module,但是file打包會(huì)帶module。
借鑒其他的博文總結(jié):
1、給引用文件設(shè)置type="module"等于給文件設(shè)置了私有作用域,xx.js文件成了單獨(dú)的模塊,運(yùn)行在自己的私有作用域中,而不是全局作用域中。
2、雖然script標(biāo)簽自帶跨域能力(這也是某些場(chǎng)合會(huì)通過jsonp結(jié)合script來請(qǐng)求資源的原因),但是這里的跨域是指的http協(xié)議(協(xié)議、域名、端口一致),file協(xié)議是不支持跨域的。
3、es6聲明type=“module”,這類使用了模塊的script是受限于同源策略的。
參考:
vue3.0 + vue-router4.0打包后頁(yè)面空白
到此這篇關(guān)于vite打包靜態(tài)文件打開顯示空白的解決的文章就介紹到這了,更多相關(guān)vite打包靜態(tài)文件空白內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Vue 數(shù)值改變頁(yè)面沒有刷新的問題解決(數(shù)據(jù)改變視圖不更新的問題)
這篇文章主要介紹了Vue 數(shù)值改變頁(yè)面沒有刷新的問題解決(數(shù)據(jù)改變視圖不更新的問題),本文結(jié)合實(shí)例代碼給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2023-09-09Vue Element前端應(yīng)用開發(fā)之根據(jù)ABP后端接口實(shí)現(xiàn)前端展示
本篇著重介紹基于ABP后端接口信息,實(shí)現(xiàn)對(duì)前端界面的開發(fā)工作。2021-05-05vue3 el-pagination 將組件中英文‘goto’ 修改 為&nbs
這篇文章主要介紹了vue3 el-pagination 將組件中英文‘goto’ 修改 為 中文到‘第幾’,通過實(shí)例代碼介紹了vue3項(xiàng)目之Pagination 組件,感興趣的朋友跟隨小編一起看看吧2024-02-02Vue使用codemirror實(shí)現(xiàn)一個(gè)可插入自定義標(biāo)簽的textarea
這篇文章主要為大家詳細(xì)介紹了Vue如何使用codemirror實(shí)現(xiàn)一個(gè)可插入自定義標(biāo)簽的textarea,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2024-02-02從vue基礎(chǔ)開始創(chuàng)建一個(gè)簡(jiǎn)單的增刪改查的實(shí)例代碼(推薦)
這篇文章主要介紹了從vue基礎(chǔ)開始創(chuàng)建一個(gè)簡(jiǎn)單的增刪改查的實(shí)例代碼,需要的朋友參考下2018-02-02vue實(shí)現(xiàn)前進(jìn)刷新后退不刷新效果
這篇文章主要介紹了vue實(shí)現(xiàn)前進(jìn)刷新,后退不刷新效果,即加載過的界面能緩存起來(返回不用重新加載),關(guān)閉的界面能被銷毀掉(再進(jìn)入時(shí)重新加載)。本文給大家分享實(shí)現(xiàn)思路,需要的朋友可以參考下2018-01-01vue動(dòng)態(tài)路由刷新失效以及404頁(yè)面處理辦法
作為一個(gè)前端新手,項(xiàng)目中遇到權(quán)限處理時(shí),通常會(huì)采用動(dòng)態(tài)添加路由的方法來實(shí)現(xiàn),下面這篇文章主要給大家介紹了關(guān)于vue動(dòng)態(tài)路由刷新失效以及404頁(yè)面處理辦法的相關(guān)資料,需要的朋友可以參考下2023-11-11