配置项说明

:::info

  • 只有以VITE_开头的变量才会被载入,访问方式:const title = import.meta.env.VITE_APP_TITLE
  • 以VITEGLOB开头的变量在打包的时候会被写入到app.config.js文件中,如需修改线上配置项可以直接修改app.config.js文件而无需重新打包 :::

    .env

    在所有环境都会被载入

  1. # 标题(用于登录页的标题、页面标签的title以及logo处的标题)
  2. VITE_APP_TITLE = 'Vue Naive Admin'
  3. # 端口号
  4. VITE_PORT = 3100
  5. # 打包时自动生成CNAME文件,用于配置github pages自定义域名,如不需要可注释或者直接删除
  6. VITE_APP_GLOB_CNAME = 'template.qszone.com'

.env.development

开发环境载入

  1. # 资源公共路径,需要以 /开头和结尾
  2. VITE_PUBLIC_PATH = '/'
  3. # 是否启用MOCK
  4. VITE_APP_USE_MOCK = true
  5. # proxy(多个proxy不能换行)
  6. VITE_PROXY = [["/api","http://localhost:8080"],["/api-test","localhost:8080"]]
  7. # base api
  8. VITE_APP_GLOB_BASE_API = '/api'
  9. # test base api
  10. VITE_APP_GLOB_BASE_API_TEST = '/api-test'

.env.production

生产环境载入

  1. VITE_PUBLIC_PATH = '/'
  2. # 是否启用MOCK
  3. VITE_APP_USE_MOCK = false
  4. # base api
  5. VITE_APP_GLOB_BASE_API = 'https://www.baidu.com'
  6. # test base api
  7. VITE_APP_GLOB_BASE_API_TEST = 'https://www.baidu.com'

.env.staging、.env.test

分别在预发布环境和测试环境载入,配置同.env.production

生产环境变量动态配置

说明

此配置参考vben admin,当项目构建完成后,会自动生成 app.config.js 文件并插入 index.html

作用

app.config.js 用于项目在打包后,需要动态修改配置的需求,如接口地址。不用重新进行打包,可在打包后修改 /dist/_app.config.js 内的变量,刷新即可更新代码内的局部变量

如何新增一个可动态修改的配置项

在 .env 或者对应的开发环境配置文件内,新增需要可动态配置的变量,以 VITEGLOB开头即可