vue-cli3 配置多环境变量方法

前端项目上线的时候 , 不可避免的会考虑到不同的运行环境需要前端请求不同服务地址的问题,所以就需要我们前端人对不同环境要求进行变量配置,而vue-cli3 搭建的项目其实看起来比 cli2 简单明了很多,官方也有相关文档对多环境变量配置的描述,大家可以点击这里去官方了解一下。

方法一:快速配置

1.首先:

通过为 .env 文件增加后缀来设置某个模式下特有的环境变量

通过传递 –mode 选项参数为命令行覆写默认的模式

在项目的根目录新建3个文件夹,分别对应开发(dev),测试(test),生产(prod)

文件命名: .env.dev , .env.test , .env.prod

vue-cli3 配置多环境变量方法

接下来是我们看一下不同文件里面的代码情况,

.env.dev

NODE_ENV = 'development'
VUE_APP_CURRENTMODE = 'dev'
VUE_APP_BASEURL = '本地开发api地址'

.env.test

NODE_ENV = 'production'
VUE_APP_CURRENTMODE = 'test'
VUE_APP_BASEURL = '测试环境api地址'

.env.prod

NODE_ENV = 'production'
VUE_APP_CURRENTMODE = 'prod'
VUE_APP_BASEURL = '正式环境api地址'

2.修改package.json 脚本:

vue-cli3 配置多环境变量方法

3.最后根据上面的配置进行打包:

npm run dev		//本地运行
npm run build:test      //测试环境打包
npm run build:pro 	//正式环境打包

网友提供的方法

一般的情况下 , 可以使用vue-cli-service环境变量进行分环境打包 ;

开发环境 , 继续使用proxy代理 ;

需要编译的环境 , 通过设置环境变量去控制打包过程 , 最终生成适用于不同环境的前端资源 ;

有关vue-cli-service环境变量的具体解释在另一篇文章中有详解 , 这里我们只关注实现

首先 , 我们需要添加各个环境的env配置文件 , 放在项目的根目录下

vue-cli3 配置多环境变量方法

我们以联调环境为例 , 添加了一个.env.build_dev 文件

.env.build_dev

NODE_ENV='production' //表明这是需要编译的环境(需要打包)
VUE_APP_CURRENTMODE='production' // 自定义的模式信息
VUE_APP_BASE_SERVER='http://****:8080' // 自定义的接口地址

在接口管理api.js文件中

import { fetchpost, fetchget, fetchput, fetchdelete } from "./config";
// 分环境打包
let baseUrl = '';
if (process.env.NODE_ENV == 'development') {
  baseUrl = "/base"
} else if (process.env.NODE_ENV == 'production') {
  baseUrl = process.env.VUE_APP_BASE_SERVER
} else {
  baseUrl = ""
}
 
export default {
  // 登录
  login(params) {
    return fetchpost(
            `${baseUrl}/apis/v1/login`,
            params
        );
    },
  // 修改密码
  setpsw(params) {
    return fetchput(
            `${baseUrl}/apis/v1/users/password`,
            params
        );
    },
    ...........略

接下来 , 我们需要在项目的package.json文件中为联调环境添加一个编译指令 “build_dev” , 并指定编译模式

package.json

"scripts": {
        "serve": "vue-cli-service serve",
        "build": "vue-cli-service build",
        "build_dev": "vue-cli-service build --mode build_dev",
        "build_pre_release": "vue-cli-service build --mode build_pre_release",
        "build_test": "vue-cli-service build --mode build_test",
        "lint": "vue-cli-service lint"
    },

这样 , 我们通过不同的指令去编译对应环境的前端资源.

方法二

另一种方式,是将前端请求的服务地址抽离出来,放进配置文件里面,

开发环境,继续使用proxy代理;

需要编译的环境,可以直接修改编译后的文件中的配置文件

这样的好处如下:

1:前端不需要重复进行打包编译;

2:自动化部署的时候可以使用脚本去替换前端资源中的配置文件;

3:如果采用前端Docker化,可以在制作镜像的过程中修改/替换配置文件;

vue-cli3 配置多环境变量方法

在里面我们简单存放一个服务地址字段

config.json

{
  "SERVER_URL": ""
}

接下来,需要保证项目开始加载前,我们已经获取到这个配置文件了,所以在main.js里面,我们需要先获取这个配置文件,再实例化vue

mian.js

import axios from 'axios'
// vue实例
function createdVue () {
  return new Vue({
    router,
    store,
    render: h => h(App)
    }).$mount("#app");
}
if (process.env.NODE_ENV == 'development') {
    // 放在public文件夹下的静态文件需要通过绝对路径去获取
    axios.get('/config.json').then(res=>{
      // 开发环境通过proxy代理的形式 , 不需要获取配置地址
      Vue.prototype.SERVER_URL = ''
      createdVue()
    })
} else if (process.env.NODE_ENV == 'production') {
    // 放在public文件夹下的静态文件需要通过绝对路径去获取
    axios.get('/config.json').then(res=>{
      // 将获取到的配置文件作为全局变量保存
      Vue.prototype.SERVER_URL = res.SERVER_URL
      // 成功获取到配置后再去创建vue实例
      createdVue()
    })
  }

一般项目中,我们都会对axios进行统一封装,为axios创建一个config.js文件,里面对axios请求头,baseUrl,请求拦截,各种请求方式进行配置

在这里我们为每个请求添加baseUrl

config.js

import axios from 'axios'
import Vue from "vue";
import qs from 'qs'
import Router from '@/router.js'
import {Message} from 'element-ui'
// axios.defaults.timeout = 10000     // 响应时间
// 获取全局变量中的服务地址
function getBaseUrl () {
  return Vue.prototype.SERVER_URL
}
// 配置请求头
axios.defaults.headers.post['Content-Type'] = 'application/json'
 
// 添加请求拦截器
axios.interceptors.request.use((config) => {
  // 为每次请求添加baseUrl  
  config.baseURL = getBaseUrl()
  if (sessionStorage.token) {
    config.headers['Authorization'] = sessionStorage.token
  }
  return config
}, (error) => {
  return Promise.reject(error)
})
 
// 添加响应拦截器
axios.interceptors.response.use((res) => {
  // 如果错误码!==0;抛出异常
  if (res.data.code && res.data.code !== 0) {
    switch (res.data.code) {
      case 1001:
        // 无权限
        Router.replace('/login')
        break;
      case 1003:
        // 访问身份不合法
        Router.replace('/login')
        break;
      default:
        break;
    }
    let message = res.data.msg || '出错了'
    return Promise.reject({message: message, err: res})
  } else {
    return Promise.resolve(res.data)
  }
}, (error) => {
  let message = '服务器错误'
  return Promise.reject({message: message, err: error})
})
 
// 返回一个Promise(发送post请求)
export function fetchpost (url, params) {
  return new Promise((resolve, reject) => {
    axios.post(url, params).then(response => {
      resolve(response.data)
    }).catch((error) => {
      reject(error)
    })
  })
}
// 返回一个Promise(发送get请求)
export function fetchget (url, params) {
  return new Promise((resolve, reject) => {
    axios.get(url, {params: params}).then(response => {
      resolve(response.data)
    }).catch((error) => {
      reject(error)
    })
  })
}
 
// 返回一个Promise(发送put请求)
export function fetchput (url, params) {
  return new Promise((resolve, reject) => {
    axios.put(url, params).then(response => {
      resolve(response.data)
    }).catch((error) => {
      reject(error)
    })
  })
}
// 返回一个Promise(发送delete请求)
export function fetchdelete (url, params) {
  return new Promise((resolve, reject) => {
    axios.delete(url, params).then(response => {
      resolve(response.data)
    }).catch((error) => {
      reject(error)
    })
  })
}

结语

以上就是vue-cli3 配置多环境变量方法,总有一种适合你。

未经允许不得转载:码云笔记 » vue-cli3 配置多环境变量方法
喜欢(0) 打赏

评论抢沙发

评论前必须登录!

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

在线客服

在线客服

  • 扫描二维码,微信联系 扫描二维码,微信联系