.env.[mode]文件中如何添加注释？

发表于 更新于 分类于 阅读次数： Changyan： 本文字数： 2.1k 阅读时长 ≈ 2 分钟
本文从抛砖引玉，从.env[mode]文件中如何添加注释入手，浅析.env[mode]文件是如何被dotenv插件加载并注入到process.env变量中的，更多请自行探索，不难。

前言

Vue-Cli 允许我们在项目根目录创建.env.[mode]文件来设置一些打包编译的启动参数，通过执行脚本的时候加mode参数，指定不同环境需要加载的配置文件

形如： .env.prod

1
2
3
NODE_ENV='production'
VUE_APP_PATH='./'
VUE_APP_RUNTIME='prod'

问题

怎么在 .env.prod 文件中添加注释呢？

分析

这要看vue是怎么解析 .env.prod 文件的

通过启动脚本参数 --mode prod，一路找到了处理 .env.prod 文件的逻辑，让我们一块看下

path：node_modules\@vue\cli-service\lib\Service.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
const dotenv = require('dotenv');

// ...

loadEnv (mode) {
    const logger = debug('vue:env')
    const basePath = path.resolve(this.context, `.env${mode ? `.${mode}` : ``}`)
    const localPath = `${basePath}.local`

    const load = envPath => {
      try {
        const env = dotenv.config({ path: envPath, debug: process.env.DEBUG })
        dotenvExpand(env)
        logger(envPath, env)
      } catch (err) {
        // only ignore error if file is not found
        if (err.toString().indexOf('ENOENT') < 0) {
          error(err)
        }
      }
    }

    load(localPath)
    load(basePath)

    // by default, NODE_ENV and BABEL_ENV are set to "development" unless mode
    // is production or test. However the value in .env files will take higher
    // priority.
    if (mode) {
      // always set NODE_ENV during tests
      // as that is necessary for tests to not be affected by each other
      const shouldForceDefaultEnv = (
        process.env.VUE_CLI_TEST &&
        !process.env.VUE_CLI_TEST_TESTING_ENV
      )
      const defaultNodeEnv = (mode === 'production' || mode === 'test')
        ? mode
        : 'development'
      if (shouldForceDefaultEnv || process.env.NODE_ENV == null) {
        process.env.NODE_ENV = defaultNodeEnv
      }
      if (shouldForceDefaultEnv || process.env.BABEL_ENV == null) {
        process.env.BABEL_ENV = defaultNodeEnv
      }
    }
  }

从上面的代码，可以得知，vue使用dotenv解析.env.prod 文件，并将环境变量从 .env[mode] 文件中加载到 process.env 环境变量中

解决（dotenv）

dotenv插件已经被 Vue-Cli 集成了

GitHub地址

README.md 中有这么一段话：

  • “# marks the beginning of a comment (unless when the value is wrapped in quotes)”

这就是我们要找的，在.env.[mode] 文件中，可以使用 # 进行注释

使用测试

  1. path: .env.prod 参数配置
1
2
3
4
NODE_ENV='production'
# VUE_APP_PATH='/pc/'
VUE_APP_PATH='./'
VUE_APP_RUNTIME='prod'
  1. package.json 文件脚本命令配置--mode参数
1
2
3
"scripts": {
    "build": "vue-cli-service build --mode prod",
  },
  1. 执行 npm run build 命令，输出如下：
1
2
NODE_ENV=== production
VUE_APP_PATH=== ./

本文到此为止，要想了解更多dotenv请自行探索，感谢观看😉

我是 甜点cc

热爱前端，也喜欢专研各种跟本职工作关系不大的技术，技术、产品兴趣广泛且浓厚，等待着一个创业机会。主要致力于分享实用技术干货，希望可以给一小部分人一些微小帮助。

我排斥“新人迷茫，老人看戏”的现象，希望能和大家一起努力破局。营造一个良好的技术氛围，为了个人、为了我国的数字化转型、互联网物联网技术、数字经济发展做一点点贡献。数风流人物还看中国、看今朝、看你我。