vue-设置项目全局配置文件可灵活切换-本地开发测试投产环境

vue-cli-plugin-app-config

介绍

一个 vue 项目配置文件管理的解决方案，可方便开发者在本地环境 / 测试环境 / 投产环境等多种配置里面快速切换

快速使用

添加插件

yarn add vue-cli-plugin-app-config

// 或者

npm i vue-cli-plugin-app-config --save-dev

应用插件到项目中

vue add vue-cli-plugin-app-config

配置插件 vue.config.js

{
   ...other config
   pluginOptions: {
      // options
      'app-config': {
        file: './app.config.js',
        default: 'dev'
      }
   }
}

插件配置项 options

配置项	默认值	描述
file	./app.config.js	配置文件路径, 默认为项目根目录，和 vue.config.js 同级
default	dev	默认使用的配置环境

app.config.js 配置文件结构示例

module.exports = {
  // 不同环境环境配置
  env: {
    // 开发环境
    dev: {apihost: 'http://local.api.com'},
    // 测试环境
    test: {apihost: 'http://test.api.com'},
    // 投产环境
    prod: {apihost: 'http://bbs.api.com'},
    ...
  },
  // 公用配置
  common: {
    // 接口超时时间
    timeout: 5000,
    // 主题配置
    theme: 'red',
    ...
  }
}

使用不同的环境启动项目 (以 yarn 为例)

开发环境

// 默认 dev 环境，所以可加可不加
yarn serve --dev

测试环境

yarn serve --test

正式环境

yarn serve --prod

用户自定义环境

yarn serve --xxx

使用不同的环境编译项目 (以 yarn 为例)

开发环境

// 默认 dev 环境，所以可加可不加
yarn build --dev

测试环境

yarn build --test

正式环境

yarn build --prod

用户自定义环境

yarn build --xxx

项目中使用配置内容

使用本插件以后，会在项目全局生成一个 $config 对象，可在任意 js 文件中通过 $config 直接获取配置内容

上文中的配置文件，以 dev 环境启动为例，最终得到的 $config 文件如下

// $config
{
  apihost: 'http://local.api.com',
  // 接口超时时间
  timeout: 5000,
  // 主题配置
  theme: 'red'
}

示例

<template lang="html">
  <div>
    apihost: {{config.apihost}}
  </div>
</template>

<script>
export default {data() {
    return {
      // 注入到当前组件
      config: $config
    }
  },
  mounted() {console.log('全局项目配置', $config)
  }
}
</script>

<style lang="css" scoped>
</style>