vue-cli3环境变量与分环境打包

第一步 : 了解环境变量概念html

咱们能够根目录中的下列文件来指定环境变量:vue

.env                # 在全部的环境中被载入
.env.local          # 在全部的环境中被载入,但会被 git 忽略
.env.[mode]         # 只在指定的模式中被载入
.env.[mode].local   # 只在指定的模式中被载入,但会被 git 忽略

环境变量文件只包含环境变量的“键=值”对:node

FOO=bar
VUE_APP_SECRET=secret // 只有VUE_APP_开头的环境变量能够在项目代码中直接使用

除了 自定义的VUE_APP_* 变量以外,在你的应用代码中始终可用的还有两个特殊的变量:webpack

  • NODE_ENV - 会是 "development"、"production" 或 "test"
    中的一个。具体的值取决于应用运行的模式。
  • BASE_URL - 会和 vue.config.js 中的 publicPath 选项相符,即你的应用会部署到的基础路径。

为一个特定模式准备的环境文件的 (例如 .env.production) 将会比通常的环境文件 (例如 .env) 拥有更高的优先级。git

模式概念:
模式是 Vue CLI 项目中一个重要的概念。通常状况下 Vue CLI 项目有三个默认模式:web

  • 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"。 vue-cli

你能够经过为 .env 文件增长后缀来设置某个模式下特有的环境变量。好比,若是你在项目根目录建立一个名为 .env.development 的文件,那么在这个文件里声明过的变量就只会在 development 模式下被载入。npm

你能够经过传递 --mode 选项参数为命令行覆写默认的模式。例如,若是你想要在构建命令中使用开发环境变量,请在你的 package.json 脚本中加入:json

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

环境变量的使用 :
只有以 VUE_APP_ 开头的变量会被 webpack.DefinePlugin 静态嵌入到客户端侧的包中(即在项目代码中使用)。你能够在应用的代码中这样访问它们:api

console.log(process.env.VUE_APP_SECRET)

理解指令 , 模式 , 环境变量之间的关系
咱们在项目中的package.json常常能看见如下这样的指令

clipboard.png

在一个 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       监听文件变化

以上是两个经常使用的cli指令 , 他们默认对应的分别是development和production模式 , 若是还想了解其余指令 , 能够访问: https://cli.vuejs.org/zh/guid... CLI 服务

那么接下来 , 咱们就开始建立一个用于打包测试环境的模式;

修改package.json
添加一行命令

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

添加.env.test文件
在项目根路径建立.env.test文件,内容为

NODE_ENV='production'  //代表这是生产环境(须要打包)
VUE_APP_CURRENTMODE='test' // 代表生产环境模式信息
VUE_APP_BASEURL='http://***.****.com:8000' // 测试服务器地址

修改项目中的api接口文件
在个人项目中,通常会建立一个api.js 来管理全部的接口url
由于咱们在本地开发环境中是经过代理来链接服务器的,因此将url写成这

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

在文件开头经过环境变量改变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 = "" 
}

当须要为测试环境进行打包的时候 , 咱们只须要运行下面指令进行打包

npm run test
相关文章
相关标签/搜索