Vue集成axios并封装教程

在Vue项目中集成axios需通过封装提升可维护性。1. 安装并引入axios，推荐创建统一请求模块如src/utils/request.js；2. 封装拦截器实现自动携带token和统一响应处理；3. 在组件中按需调用封装方法如get或post；4. 支持多环境配置，通过.env文件自动切换API地址，提高协作效率。

在Vue项目中集成第三方库是很常见的需求，比如使用 axios 发送 HTTP 请求。直接在组件里调用 axios 虽然可行，但不利于维护和统一处理。因此，合理封装是关键。

安装并引入 axios

首先需要安装 axios：

npm install axios

然后可以在需要用到的组件中单独引入，或者更推荐的做法是在项目中创建一个统一的请求模块。例如，在 src/utils 目录下新建一个 request.js 文件：

import axios from 'axios';

const service = axios.create({
  baseURL: process.env.VUE_APP_API_BASE_URL, // 设置基础路径
  timeout: 5000, // 超时时间
});

export default service;

这样就可以在整个项目中通过引入这个封装好的实例来发送请求了。

封装拦截器提升一致性

实际开发中，我们通常会在请求发出前加 token，或者对响应做统一处理。这时候可以利用 axios 的拦截器功能。

在 request.js 中添加：

// 请求拦截器
service.interceptors.request.use(
  config => {
    const token = localStorage.getItem('token');
    if (token) {
      config.headers['Authorization'] = `Bearer ${token}`;
    }
    return config;
  },
  error => {
    return Promise.reject(error);
  }
);

// 响应拦截器
service.interceptors.response.use(
  response => {
    const res = response.data;
    if (res.code !== 200) {
      // 可以在这里统一提示错误信息
      console.error(res.message || 'Error');
      return Promise.reject(new Error(res.message || 'Error'));
    } else {
      return res;
    }
  },
  error => {
    console.error('网络异常', error);
    return Promise.reject(error);
  }
);

这样就实现了请求前自动带上 token、响应后统一判断状态码等操作，避免重复代码。

在组件中使用封装好的方法

封装好之后，使用起来也非常方便。比如在一个 Vue 组件中：

import request from '@/utils/request';

export default {
  methods: {
    async fetchData() {
      try {
        const res = await request.get('/api/some-data');
        console.log(res);
      } catch (error) {
        console.error('请求失败', error);
      }
    },
  },
};

如果是 POST 请求，也可以这样写：

const res = await request.post('/api/submit', { name: 'test' });

这样写不仅清晰，也便于后期维护，比如更换接口地址或统一处理错误逻辑。

按需扩展：支持多个环境配置

如果你的项目有多个环境（如开发、测试、生产），可以在 vue.config.js 或 .env 文件中设置不同的 API 地址。

比如在 .env.development 中：

VUE_APP_API_BASE_URL = "https://dev-api.example.com"

在 .env.production 中：

VUE_APP_API_BASE_URL = "https://api.example.com"

这样在不同环境下，baseURL 会自动切换，不需要手动修改。

基本上就这些。封装得当的话，不仅让代码更整洁，也能提高协作效率。