vue-cli3環(huán)境變量與分環(huán)境打包的方法示例

2019-11-19 12:07:21

字體：大中小

供稿：網(wǎng)友

第一步 : 了解環(huán)境變量概念

我們可以根目錄中的下列文件來指定環(huán)境變量:

.env        # 在所有的環(huán)境中被載入.env.local     # 在所有的環(huán)境中被載入，但會被 git 忽略.env.[mode]     # 只在指定的模式中被載入.env.[mode].local  # 只在指定的模式中被載入，但會被 git 忽略

環(huán)境變量文件只包含環(huán)境變量的“鍵=值”對：

FOO=barVUE_APP_SECRET=secret // 只有VUE_APP_開頭的環(huán)境變量可以在項(xiàng)目代碼中直接使用

除了自定義的VUE_APP_* 變量之外，在你的應(yīng)用代碼中始終可用的還有兩個特殊的變量：

NODE_ENV - 會是 "development"、"production" 或 "test"中的一個。具體的值取決于應(yīng)用運(yùn)行的模式。
BASE_URL - 會和 vue.config.js 中的 publicPath 選項(xiàng)相符，即你的應(yīng)用會部署到的基礎(chǔ)路徑。

為一個特定模式準(zhǔn)備的環(huán)境文件的 (例如 .env.production) 將會比一般的環(huán)境文件 (例如 .env) 擁有更高的優(yōu)先級。

模式概念:

模式是 Vue CLI 項(xiàng)目中一個重要的概念。一般情況下 Vue CLI 項(xiàng)目有三個默認(rèn)模式：

development 模式用于 vue-cli-service serve
production 模式用于 vue-cli-service build 和 vue-cli-service test:e2e
test 模式用于 vue-cli-service test:unit

模式不等同于 NODE_ENV，一個模式可以包含多個環(huán)境變量。也就是說，每個模式都將 NODE_ENV的值設(shè)置為模式的名稱(可重新賦值更改)――比如在 development 模式下 NODE_ENV 的值會被設(shè)置為 "development"。

你可以通過為 .env 文件增加后綴來設(shè)置某個模式下特有的環(huán)境變量。比如，如果你在項(xiàng)目根目錄創(chuàng)建一個名為 .env.development 的文件，那么在這個文件里聲明過的變量就只會在 development 模式下被載入。

你可以通過傳遞 --mode 選項(xiàng)參數(shù)為命令行覆寫默認(rèn)的模式。例如，如果你想要在構(gòu)建命令中使用開發(fā)環(huán)境變量，請?jiān)谀愕?package.json 腳本中加入：

"dev-build": "vue-cli-service build --mode development",

環(huán)境變量的使用 :

只有以 VUE_APP_ 開頭的變量會被 webpack.DefinePlugin 靜態(tài)嵌入到客戶端側(cè)的包中(即在項(xiàng)目代碼中使用)。你可以在應(yīng)用的代碼中這樣訪問它們：

console.log(process.env.VUE_APP_SECRET)

理解指令 , 模式 , 環(huán)境變量之間的關(guān)系

我們在項(xiàng)目中的package.json經(jīng)常能看見以下這樣的指令

在一個 Vue CLI 項(xiàng)目中，@vue/cli-service 安裝了一個名為 vue-cli-service 的命令。你可以在 npm scripts 中以 vue-cli-service、或者從終端中以 ./node_modules/.bin/vue-cli-service 訪問這個命令。

vue-cli-service serve

用法：vue-cli-service serve [options] [entry]
選項(xiàng)：
--open 在服務(wù)器啟動時(shí)打開瀏覽器
--copy 在服務(wù)器啟動時(shí)將 URL 復(fù)制到剪切版
--mode 指定環(huán)境模式 (默認(rèn)值：development)
--host 指定 host (默認(rèn)值：0.0.0.0)
--port 指定 port (默認(rèn)值：8080)
--https 使用 https (默認(rèn)值：false)

vue-cli-service build

用法：vue-cli-service build [options] [entry|pattern]
選項(xiàng)：
--mode 指定環(huán)境模式 (默認(rèn)值：production)
--dest 指定輸出目錄 (默認(rèn)值：dist)
--modern 面向現(xiàn)代瀏覽器帶自動回退地構(gòu)建應(yīng)用
--target app | lib | wc | wc-async (默認(rèn)值：app)
--name 庫或 Web Components 模式下的名字 (默認(rèn)值：package.json 中的 "name" 字段或入口文件名)
--no-clean 在構(gòu)建項(xiàng)目之前不清除目標(biāo)目錄
--report 生成 report.html 以幫助分析包內(nèi)容
--report-json 生成 report.json 以幫助分析包內(nèi)容
--watch 監(jiān)聽文件變化

以上是兩個常用的cli指令 , 他們默認(rèn)對應(yīng)的分別是development和production模式 , 如果還想了解其他指令 , 可以訪問: https://cli.vuejs.org/zh/guide/cli-service.html#cli-%E6%9C%8D%E5%8A%A1 CLI 服務(wù)

那么接下來 , 我們就開始創(chuàng)建一個用于打包測試環(huán)境的模式;

修改package.json

添加一行命令

"test": "vue-cli-service build --mode test"

添加.env.test文件

在項(xiàng)目根路徑創(chuàng)建.env.test文件，內(nèi)容為

NODE_ENV='production' //表明這是生產(chǎn)環(huán)境(需要打包)VUE_APP_CURRENTMODE='test' // 表明生產(chǎn)環(huán)境模式信息VUE_APP_BASEURL='http://***.****.com:8000' // 測試服務(wù)器地址

修改項(xiàng)目中的api接口文件

在我的項(xiàng)目中,一般會創(chuàng)建一個api.js 來管理所有的接口url

因?yàn)槲覀冊诒镜亻_發(fā)環(huán)境中是通過代理來連接服務(wù)器的,所以將url寫成這

`${baseUrl}/apis/v1/login`,

在文件開頭通過環(huán)境變量改變baseUrl

let baseUrl = '';if (process.env.NODE_ENV == 'development') { baseUrl = "" } else if (process.env.NODE_ENV == 'production') { baseUrl = process.env.VUE_APP_BASEURL} else { baseUrl = "" }

當(dāng)需要為測試環(huán)境進(jìn)行打包的時(shí)候 , 我們只需要運(yùn)行下面指令進(jìn)行打包