一、环境变量
我们在使用 Vue-cli 创建的Vue项目中,可以在构建和运行时为项目设置环境变量,这些环境变量会根据环境(模式)的不同,而自动注入到项目中,也就是说我们可以根据环境不同,设置不同的环境变量或者给同个环境变量赋予不同的值,从而实现不同的效果。
但是请不要在环境变量中存储任何机密敏感信息(秘钥等),因为环境变量会随着构建打包嵌入到输出的代码中,这意味着任何人都有可能看到这些变量的值,从而造成信息泄露。
1、 环境变量只能放置在项目根目录下的特定.env
环境文件中:
.env // 通用文件,在所有环境中都会被注入到项目中
.env.local // 本地通用文件,只有在本地运行的所有环境中都会被注入到项目中,但是会被git忽略,不能提交到git仓库中
.env.[mode] // 模式专用文件,只有在指定的mode模式下,才会注入到项目中
.env.[mode].local // 本地模式专用文件,只有在本地运行的指定的mode模式下,才会注入到项目中,且会被git忽略,不能提交到git仓库中
// 例如
.env.development // development模式专用文件,只有在development模式下,才会注入到项目中
.env.development.local // 本地development模式专用文件
如果项目中同时声明了多个个不同类型环境文件,并且这些文件中存在同名的环境变量时,会根据 .env.[mode].local
> .env.[mode]
> .env.local
> .env
的优先级先后顺序决定环境变量的值,最终环境变量的值会取优先级最高的环境文件中的那个值。
// 多个环境文件
// .env
VUE_APP_AAA=aaa
// 如果只有上面的文件 则最终变量值为 aaa
// .env.local
VUE_APP_AAA=bbb
// 如果只有上面的两个文件 则最终变量值为 bbb
// .env.development
VUE_APP_AAA=ccc
// 如果只有上面的三个文件 则最终变量值为 ccc
// .env.development.loacal
VUE_APP_AAA=ddd
// 如果只有上面的四个文件 则最终变量值为 ddd
由于环境文件是在运行vue-cli-service
运行命令时载入的,因此当我们修改了环境文件时,必须重新启动项目才能生效。
2、 环境变量以键值对的形式在环境文件中声明
目前只有NODE_ENV
、BASE_URL
两个特殊变量和以VUE_APP_
开头声明的自由变量,能够通过webpack.DefinePlugin
注入到项目中:
VUE_APP_VAR=123abc
BASE_URL=./abc(不推荐修改该变量)
NODE_ENV=test (不推荐修改该变量)
两个特殊变量NODE_ENV
和BASE_URL
都拥有自己的默认属性值,因此不建议在环境文件中声明同名变量:
NODE_ENV
: 值为"development"
、"production"
或"test"
三者之一,具体的值取决于项目运行的模式。BASE_URL
:值为vue.config.js
中的publicPath
选项的值,即项目在部署时的基础路径。
3、 环境变量在项目中需要通过process.env.变量名
的形式来访问
如果我们想在项目的页面中使用环境变量,那么我们需要通过process.env.变量名
的方式来访问对应值:
console.log(process.env.VUE_APP_VAR) // 123abc
console.log(process.env.BASE_URL) // ./abc
console.log(process.env.NODE_ENV) // test
除了在普通页面中使用环境变量之外,我们也可以在项目的public/index.html
中以HTML插值(lodash template
语法)的方式来使用环境变量:
① <%= 变量名 %>
:用来做不转义插值,如果插入的环境变量中,包含HTML标签,则会被浏览器解析,类似于设置innerHTML
。
② <%- 变量名 %>
:用来做HTML转义插值,如果插入的环境变量中,包含HTML标签,不会被浏览器解析,只是作为字符串插入到页面上,类似于设置innerText
。
③ <% if(变量名) %>
:用来做JavaScript流程控制。
// .env
// 声明一个带有HTML标签的环境变量
VUE_APP_HTML=<h3>h3标题</h3>
<!-- index.html -->
<!-- 在元素属性中使用 -->
<link rel="icon" href="<%= BASE_URL %>favicon.ico">
<!-- 在JS中使用 -->
<script>
console.log('process.env.NODE_ENV----<%= NODE_ENV %>');
</script>
<!-- 转义插值 -->
<div><%- VUE_APP_HTML %></div>
<!-- 不转义插值 -->
<div> <%= VUE_APP_HTML %> </div>
<!-- 进行JS流程控制 -->
<% if(NODE_ENV==='development' ) { %>
<div>开发</div>
<% } %>
<% if(NODE_ENV==='test' ) { %>
<div>测试</div>
<% } %>
<% if(NODE_ENV==='production' ) { %>
<div>生产</div>
<% } %>
页面效果:
二、模式
默认情况下,一个通过Vue Cli 创建的Vue项目,拥有三种模式:development
、test
、production
,这三种模式分别默认对应了不同的项目执行命令,从而创建不同的webpack 配置:
① development
该模式为开发模式,默认对应vue-cli-service serve
命令,也是默认的启动项目运行命令,该模式将会创建一个用于开发时快速构件的webpack配置,启用代码热更新、不会对代码进行优化和压缩、打包速度快但生成的代码体积较大。
② test
该模式为测试模式,默认对应vue-cli-service test:unit
命令,该模式将会创建一个优化过后的,用于单元测试的 webpack 配置,它并不会处理图片以及一些对单元测试非必需的其他资源,只会去执行所有的测试用例,并在测试完成后自动关闭。
③ production
该模式为生产模式,默认对应vue-cli-service build
和vue-cli-service test:e2e
命令,该模式将会创建一个用于部署的webpack配置,对项目进行性能优化,对代码进行优化和压缩,并打包生成用于在生产环境部署的文件,打包速度会比较慢,但是生成的代码文件体积较小,加载速度较快。
除了根据执行的命令,运行对应的默认项目模式之外,我们还可以通过在执行命令时,在命令后面加上--mode 模式
,覆盖默认的模式,显式的指明要运行的项目模式。
这三种模式除了会决定webpack配置之外,还会创建一个名为NODE_ENV
的环境变量,该环境变量的值为当前的项目模式:development
、test
、production
。如果我们在对应的环境文件中提前声明了环境变量NODE_ENV
(最好不要!),那么我们需在在执行vue-cli-service ***
命令之前移除掉这个环境变量,或者在执行命令时,显式的指明要运行的项目模式。否则该环境变量的值,会干扰项目的运行模式。
// package.json(待补充)
"scripts": {
"serve": "vue-cli-service serve", // 默认为 development 模式
"build": "vue-cli-service build", // 默认为 production 模式
"test": "vue-cli-service test:unit", // 默认为 test 模式
"serve2": "vue-cli-service serve --mode production", // 显式的指定运行 production 模式
"build2": "vue-cli-service build --mode test", // 显式的指定运行 test 模式
"test2": "vue-cli-service test:unit --mode development", // 显式的指定运行 development 模式
},
在页面中获取项目的运行模式:
// process.env.NODE_ENV 即可获取运行模式
mounted() {
console.log(process.env.NODE_ENV);
},
三、参考文档
Vue Cli - 模式和环境变量
Vue Cli - 插值