詳解vue-cli3環境變量與分環境打包方法

此篇文章會先講具體操作步驟，后面會介紹原理，如時間緊急只看第一部分即可

一、（具體步驟，以測試環境模式為例）

1、修改package.json，在script里面加一行內容

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

2、添加.env.test文件
     在項目根據經創建.env.test文件，內容

NODE_ENV='production'  // 表明這是生產環境（需要打包）
VUE_APP_CURRENTMODE='test'  // 表明生產環境模式信息
VUE_APP_BASEURL='http://localhost:8080'  // 測試服務器地址

3、修改項目中的api接口文件，或者在自己建的config文件夾里修改，或者直接在跨域代理部分修改，根據個人喜好而定。（以api為例）
      項目中一般會創建一個api.js來管理所有的接口URL，因在本地開發中是通過代理來連接服務器的，所以可將url寫成

`${baseUrl}/api/getUserInfo`

文件開頭通過環境變量改變baseUrl

let baseUrl = ''
if (process.env.NODE_ENV === 'development') { // 開發
  baseUrl = ''
} else if (process.env.NODE_ENV === 'production' && process.env.VUE_APP_CURRENTMODE === 'test') { // 測試
  baseUrl = process.env.VUE_APP_BASEURL
} else { // 生產
  baseUrl = ''
}

4、打包

當需要在測試環境下進行測試時，運行指令打包

npm run test
or
cnpm run test

二、基本原理介紹

1、了解環境變量概念
我們可以在根目錄的下列文件中指定環境變量

.env  // 在所有的環境中被載入
.env.local  // 在所有的環境中被載入，但會被git忽略
.env.[mode]  // 只在指定的模式中被載入，上述例子屬於此類型
.env.[mode].local  // 只在指定的模式中被載入，但會被git忽略

環境變量文件中只包含環境變量的“鍵=值”對

NODE_ENV='production'  
VUE_APP_CURRENTMODE='test'  // 只有VUE_APP開頭的環境變量可以在項目代碼中直接使用

除了自定義的VUE_APP_*變量之外，還有兩個在應用中始終可用的變量：

• NODE_ENV - 會是 "development"、"production" 或 "test"中的一個。具體的值取決於應用運行的模式。
• BASE_URL - 會和 vue.config.js 中的 publicPath 選項相符，即你的應用會部署到的基礎路徑。
  為一個特定模式准備的環境文件 (例如 .env.production) 將會比一般的環境文件 (例如 .env) 擁有更高的優先級。

2. 模式概念
   一般情況下Vue Cli有三個默認模式：

• development 模式用於 vue-cli-service serve
• production 模式用於 vue-cli-service build 和 vue-cli-service test:e2e
• test 模式用於 vue-cli-service test:unit
  模式不等於NODE_ENV，一個模式有多個環境變量。即每個模式都可將NODE_ENV的值設置為模式的名稱（可重新賦值更改），比如在development模式下NODE_ENV的值會被設置為“development”。
  你可以通過為 .env 文件增加后綴來設置某個模式下特有的環境變量。比如，如果你在項目根目錄創建一個名為 .env.development 的文件，那么在這個文件里聲明過的變量就只會在 development 模式下被載入。
  你可以通過傳遞 --mode 選項參數為命令行覆寫默認的模式。例如，如果你想要在構建命令中使用開發環境變量，請在你的 package.json 腳本中加入：

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

  3、環境變量的使用只有以 VUE_APP_ 開頭的變量會被 webpack.DefinePlugin 靜態嵌入到客戶端的包中(即在項目代碼中使用)。你可以在應用的代碼中這樣訪問它們

  console.log(process.env.VUE_APP_SECRET)

  4、理解指令，模式，環境變量之間的關系，我們在package.json中經常看到這樣的指令：

  "scripts": {
      "serve": "vue-cli-service serve",
      "test": "vue-cli-service build --mode test",
      "build": "vue-cli-service build",
      "lint": "vue-cli-service lint",
      "test:e2e": "vue-cli-service test:e2e",
      "test:unit": "vue-cli-service test:unit"
    },

  在一個 Vue CLI 項目中，@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]
  選項：
  --open 在服務器啟動時打開瀏覽器
  --copy 在服務器啟動時將 URL 復制到剪切版
  --mode 指定環境模式 (默認值：development)
  --host 指定 host (默認值：0.0.0.0)
  --port 指定 port (默認值：8080)
  --https 使用 https (默認值：false)
  vue-cli-service build
  用法：vue-cli-service build [options] [entry|pattern]
  選項：
  --mode 指定環境模式 (默認值：production)
  --dest 指定輸出目錄 (默認值：dist)
  --modern 面向現代瀏覽器帶自動回退地構建應用
  --target app | lib | wc | wc-async (默認值：app)
  --name 庫或 Web Components 模式下的名字 (默認值：package.json 中的 "name" 字段或入口文件名)
  --no-clean 在構建項目之前不清除目標目錄
  --report 生成 report.html 以幫助分析包內容
  --report-json 生成 report.json 以幫助分析包內容
  --watch 監聽文件變化