process.env.NODE_ENV是什么

process.env 是 Node.js 中的一个环境对象。
其中保存着系统的环境的变量信息。
可使用 Node.js 命令行工具直接进行查看。

命令行中执行 node -> process.env

 process.env 包含着关于系统环境的信息,但是并不存在 NODE_ENV 这个东西,需要自己手动配置,这个变量主要用于标识当前的环境(生产环境,开发环境)。
不同系统有不同的环境变量配置方式

vue-cli3使用DefinePlugin方式帮你把process.env.NODE_ENV配置好了,我们不需要再自己去配置。

vue-cli3 的三种模式

  1. development 模式
    1. vue-cli-service serve 启动
    2. 默认会去加载 .env ,.env.development, .env.development.local 配置文件
    3. 只有以 VUE_APP_ 开头的变量会被嵌入到客户端中
    4. 在vue文件中,使用 process.env 获取配置文件中的信息
    5. 默认 process.env.NODE_ENV === 'development'
  2. production 模式
    1. vue-cli-service build 或者 vue-cli-service test:e2e 启动
    2. 默认会去加载 .env , .env.production, .env.production.local配置文件
    3. 只有以 VUE_APP_ 开头的变量会被嵌入到客户端中
    4. 在vue文件中,使用 process.env 获取配置文件中的信息
    5. 默认 process.env.NODE_ENV === 'production'
  3. test 模式
    1. vue-cli-service test:unit 启动
    2. 默认会去加载 .env ,.env.test, .env.test.local 配置文件
    3. 只有以 VUE_APP_ 开头的变量会被嵌入到客户端中
    4. 在vue文件中,使用 process.env 获取配置文件中的信息

总结
不管什么模式,都会去加载 .env 配置文件
模式可以自定义,使用命令 vue-cli-service build --mode staging, staging就是自定义的模式名字
配置文件则会加载 .env ,.env.staging, .env.staging.local 配置文件
只有以 VUE_APP_ 开头的变量会被嵌入到客户端中
 

模式

是 Vue CLI 项目中一个重要的概念。默认情况下,一个 Vue CLI 项目有三个模式:

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

你可以通过传递 --mode 选项参数为命令行覆写默认的模式。例如,如果你想要在构建命令中使用开发环境变量:

vue-cli-service build --mode development

当运行 vue-cli-service 命令时,所有的环境变量都从对应的环境文件中载入。如果文件内部不包含 NODE_ENV 变量,它的值将取决于模式,例如,

在 production 模式下被设置为 "production"

在 test 模式下被设置为 "test"

默认则是 "development"

环境变量

你可以在你的项目根目录中放置下列文件来指定环境变量:

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

请注意:只有 NODE_ENVBASE_URL 和以 VUE_APP_ 开头的变量将通过 webpack.DefinePlugin 静态地嵌入到客户端侧的代码中。这是为了避免意外公开机器上可能具有相同名称的私钥。

环境文件加载优先级

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

此外,Vue CLI 启动时已经存在的环境变量拥有最高优先级,并不会被 .env 文件覆写。

.env 环境文件是通过运行 vue-cli-service 命令载入的,因此环境文件发生变化,你需要重启服务

示例:Staging 模式

假设我们有一个应用包含以下 .env 文件:

VUE_APP_TITLE=My App

和 .env.staging 文件:

NODE_ENV=production
VUE_APP_TITLE=My App (staging)
  • vue-cli-service build 会加载可能存在的 .env.env.production 和 .env.production.local 文件然后构建出生产环境应用。

  • vue-cli-service build --mode staging 会在 staging 模式下加载可能存在的 .env.env.staging 和 .env.staging.local 文件然后构建出生产环境应用。

这两种情况下,根据 NODE_ENV,构建出的应用都是生产环境应用,但是在 staging 版本中,process.env.VUE_APP_TITLE 被覆写成了另一个值

在客户端侧代码中使用环境变量

只有以 VUE_APP_ 开头的变量会被 webpack.DefinePlugin 静态嵌入到客户端侧的包中。你可以在应用的代码中这样访问它们:

console.log(process.env.VUE_APP_SECRET)

在构建过程中,process.env.VUE_APP_SECRET 将会被相应的值所取代。在 VUE_APP_SECRET=secret 的情况下,它会被替换为 "secret"

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

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

所有解析出来的环境变量都可以在 public/index.html 中以 HTML 插值中介绍的方式使用。

应用
有了模式的概念,就可以根据不同的环境配置模式,就不用每次打包时都去更改 vue.config.js 文件了。比如在测试环境和生产环境, publicPath参数 (部署应用包时的基本 URL) 可能不同。遇到这种情况就可以在 vue.config.js 文件中,将 publicPath 参数设置为:

publicPath: process.env.BASE_URL


设置之后,再在各个 .env.[mode] 文件下对 BASE_URL 进行配置就行了,这样就避免了每次修改配置文件的尴尬。其他的配置也是同理。

Logo

前往低代码交流专区

更多推荐