Vite多环境配置及变量识别规则

 更新时间:2023年09月21日 10:57:01   作者:开发小师傅  
这篇文章主要为大家介绍了Vite多环境配置时间及vite识别环境变量的规则,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

多环境配置的实现方式

使用vite创建的项目,相比原来的webpack项目确实在性能上带来了非常大的提升,我自己练手的一个项目也是使用vite+typescript+vue3来构建的。在实际开发场景中,我们很多时候会用到多环境配置,一般项目至少会区分dev和prod环境,然后在不同的环境下给相同参数设置一个不一样的值。在vite中也提供了这种能力,在官方文档中给出了一个示例:

.env                # 所有情况下都会加载
.env.local          # 所有情况下都会加载,但会被 git 忽略
.env.[mode]         # 只在指定模式下加载
.env.[mode].local   # 只在指定模式下加载,但会被 git 忽略

1. envDir

按照官方所说,vite会从环境目录中加载我们编写的.env.[mode]相关文件,这里默认取的是项目根目录,在实际开发时,我们肯定希望将配置文件放置在单独的文件夹下,这样可以使项目结构更加清晰,那么如何指定vite加载环境配置的目录呢?我们可以通过在vite.config.ts中指定envDir来告诉vite多环境配置文件加载的路径:

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import vueJsx from '@vitejs/plugin-vue-jsx'
// https://vitejs.dev/config/
export default defineConfig({
  envDir: "./viteEnv",//这里使用相对路径,绝对路径其实也可以
  server:{
    port: 3001,
    strictPort: true
  },
  plugins: [vue(), vueJsx()]
})

为了探究各个文件加载的情况,我这里创建了5个文件:

viteEnv/
    |--.env.local
    |--.env.develop
    |--.env.develop.local
    |--.env.production
    |--.env.production.local
# .env.local
# 所有模式下都会加载,但是会被git忽略
VITE_APP_NAME= venus
# .env.develop 测试环境参数值
VITE_OWNER=developer
VITE_POSITION=shanghai
VENUS_CONNECTION_TIMEOUT = 30000
# .env.develop.local 仅在develop模式下加载,但是会被git忽略,相同变量名时,此文件中的优先
VENUS_CONNECTION_TIMEOUT = 10000
# env.production 生产环境参数值
VITE_OWNER=production
VITE_POSITION=china
VENUS_CONNECTION_TIMEOUT = 3600

然后修改package.json,通过不同的指令,来启动不同环境:

  "scripts": {
    "start": "vite --mode develop",
    "start:prod": "vite --mode production",
    "build": "vue-tsc --noEmit && vite build --mode develop",
    "build:prod": "vue-tsc --noEmit && vite build --mode production",
    "preview": "vite preview"
  }

2. vite识别环境变量的规则

vite并非将你写在配置文件中的所有变量(或者说参数)都会透传给客户端,在我们没有特殊配置的时候,它只会识别VITE_开头的参数,我们可以在入口文件中打印一下:

# main.ts是我这个项目的入口文件,相关代码会在客户端执行,在这里打印一下变量
console.log(import.meta.env)

结果如下:

{
  "VITE_OWNER": "developer",
  "VITE_POSITION": "shanghai",
  "VITE_APP_NAME": "venus",
  "BASE_URL": "/",
  "MODE": "develop",
  "DEV": true,
  "PROD": false,
  "SSR": false
}

可以看到只有我们写的VITE_开头的变量才能打印出来。

其他变量是vite默认提供的几个值,含义如下:

import.meta.env.MODE: {string} 应用运行的模式。
import.meta.env.BASE_URL: {string} 部署应用时的基本 URL。他由base 配置项决定。
import.meta.env.PROD: {boolean} 应用是否运行在生产环境。
import.meta.env.DEV: {boolean} 应用是否运行在开发环境 (永远与 import.meta.env.PROD相反)。

那么有没有什么办法指定我们要读哪些参数呢,VITE_开头的这个规则是不是可以修改的?其实是可以的,我们在vite.config.ts中新加入一个参数envPrefix:

export default defineConfig({
  envDir: "./viteEnv",
  envPrefix: ["VITE", "VENUS"], //这个时候,我们可以将VITE_、VENUS_开头的变量统统透传给客户端
  server:{
    port: 3001,
    strictPort: true
  },
  plugins: [vue(), vueJsx()]
})

3. 同样的参数名,在.env.[mode], .env.local, .env.[mode].local中具有怎样的优先级顺序?

我们在.env.local, .env.develop.local, .env.develop中配置一个相同的参数VENUS_CONNECTION_TIMEOUT,然后在客户端打印就会发现,

.env.[mode].local 这个文件中的优先级最高

.env.[mode] 优先级次之

.env.local 优先级最低

4. 在服务端如何获取到env中的变量参数

上面我们看到的是vite将env中的变量透传给客户端的情况,然而有些参数我们可能需要在服务端用到,这个时候如何获取呢?以vite.config.ts文件为例,这是一个配置文件,在服务端启动时加载,相关内容会打印到服务端的控制台上。
vite提供了一个loadEnv函数,用于加载到相关参数

import { defineConfig,loadEnv } from 'vite'
import vue from '@vitejs/plugin-vue'
import vueJsx from '@vitejs/plugin-vue-jsx'
//在服务端获取配置参数
const console = require("console")
console.log(loadEnv('develop', './viteEnv'))
// https://vitejs.dev/config/
export default defineConfig({
  envDir: "./viteEnv",
  envPrefix: ["VITE", "VENUS"],
  server:{
    port: 3001,
    strictPort: true
  },
  plugins: [vue(), vueJsx()]
})

这样就可以在服务端获取到相关参数了,需要注意的是,我们在下面自定义的VENUS_开头的参数并不会获取到,如果需要,我们要在loadEnv函数参数中显式的指定前缀:

loadEnv('develop', './viteEnv', ["VITE", "VENUS"])

5. 变更为生产模式

这里是指在非生产模式下,将程序运行模式修改为生产模式,官方举了一个staging的例子,staging表示预发环境,在一些大公司,会有这样一个环境,用做准生产验证,这个环境启动时,我们可能希望staging应用应该具有类似于生产的行为。
只需要在.env.[mode]文件中加入一个参数:

NODE_ENV=production

然后我们就会发现,vite默认参数中用来标识生产的PROD值就会变为true。

{
  "VITE_USER_NODE_ENV": "production",
  "VITE_OWNER": "developer",
  "VITE_POSITION": "shanghai",
  "VITE_APP_NAME": "venus",
  "VENUS_CONNECTION_TIMEOUT": "600",
  "BASE_URL": "/",
  "MODE": "develop",
  "DEV": false,
  "PROD": true, //已经变为生产环境
  "SSR": false
}

为什么会是这样一个参数呢?看名字,这个似乎和node有关系,我们在vite.config.ts中打印一下node的环境变量看一下:

const process = require("process")
console.log(process.env)

环境变量中确实多了一个这样的参数。为什么会这样呢?这个值不仅将我的环境变成了生产模式,这个参数还出现在了nodejs的环境变量中。我猜测有两种可能:

1是NODE_ENV是个vite和nodejs都能识别的特殊参数,可以起到改变环境模式的作用。

2是vite的env中配置的NODE_开头的参数都会被传递给nodejs,用于控制nodejs的行为。

于是我又配置了一个NODE_DEMO,接着打印process.env,却发现并没有在这里出现。看来NODE_ENV确实是个特殊值。

这个项目是我自己准备拿来学习vue3的练手项目,想看完整代码的同学可以通过下面的地址访问到:
https://gitlab.com/Flnn/venus-admin

以上就是Vite多环境配置及变量识别规则的详细内容,更多关于Vite多环境配置变量识别的资料请关注脚本之家其它相关文章!

相关文章

  • vue使用关于speak-tss插件的详细介绍及一些配置项

    vue使用关于speak-tss插件的详细介绍及一些配置项

    本文详细介绍了speak-tss插件在Vue3中的使用方法和配置,首先需要下载依赖,然后引入插件,并进行实例化和配置,配置项包括音量、语言、语音、语速、音调等,speak-tss支持多种语言和语音,适用于需要文本语音播报的场景
    2024-09-09
  • vue shallowRef作用及引发问题详解

    vue shallowRef作用及引发问题详解

    这篇文章主要为大家介绍了vue shallowRef作用及引发问题详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • vue-cli 首屏加载优化问题

    vue-cli 首屏加载优化问题

    这篇文章主要介绍了vue-cli 首屏加载优化问题,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-11-11
  • 解决vue一个页面中复用同一个echarts组件的问题

    解决vue一个页面中复用同一个echarts组件的问题

    这篇文章主要介绍了解决vue一个页面中复用同一个echarts组件的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-07-07
  • vue3封装数字滚动组件的实现示例

    vue3封装数字滚动组件的实现示例

    本文主要介绍了vue3封装数字滚动组件的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-08-08
  • Vue Echarts实现图表轮播图以及图表组件封装和节流函数优化讲解

    Vue Echarts实现图表轮播图以及图表组件封装和节流函数优化讲解

    这篇文章主要介绍了在Vue中优雅的使用Echarts实现图表轮播图、Echarts图表组件封装、节流函数优化图表性能,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧
    2023-01-01
  • vue3自定义组件之v-model实现父子组件双向绑定

    vue3自定义组件之v-model实现父子组件双向绑定

    这篇文章主要介绍了vue3自定义组件之v-model实现父子组件双向绑定方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-08-08
  • 解决vue中修改了数据但视图无法更新的情况

    解决vue中修改了数据但视图无法更新的情况

    今天小编就为大家分享一篇解决vue中修改了数据但视图无法更新的情况,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-08-08
  • Vue.js实战之通过监听滚动事件实现动态锚点

    Vue.js实战之通过监听滚动事件实现动态锚点

    监听事件是我们在使用vue.js的时候经常使用的一个功能,下面这篇文章主要介绍了Vue.js实战之通过监听滚动事件实现动态锚点 的相关资料,文中通过示例代码介绍的非常详细,相信对大家具有一定的参考价值,需要的朋友们下面来一起看看吧。
    2017-04-04
  • Vue 富文本编辑器tinymce的安装配置使用教程

    Vue 富文本编辑器tinymce的安装配置使用教程

    TinyMCE是一个轻量级的基于浏览器的所见即所得编辑器,由JavaScript写成,TinyMCE是一个根据LGPL license发布的自由软件,你可以把它用于商业应用,这篇文章主要介绍了Vue 富文本编辑器tinymce的安装教程,需要的朋友可以参考下
    2023-09-09

最新评论