Vue 项目中引入 Axios 详解

在 Vue 项目中，axios 是一个非常流行的 HTTP 客户端，用于向服务器发送请求并处理响应。本文将详细说明如何在 Vue 项目中引入 Axios 插件，以及如何进行基本的配置，包括构建、配置域名、设置全局错误拦截等。

1. 引入 Axios

首先，你需要在项目中安装 axios。你可以使用 npm 或 yarn 进行安装。

npm install axios
# 或者
yarn add axios

安装完成后，可以在 Vue 组件中直接使用 axios，也可以将其配置为全局插件。

在 Vue 项目中使用 Axios

在 Vue 组件中引入并使用 axios 非常简单：

<script>
import axios from 'axios';export default {data() {return {info: null};},mounted() {axios.get('https://api.example.com/data').then(response => {this.info = response.data;}).catch(error => {console.error("There was an error!", error);});}
};
</script>

上面的代码展示了如何在组件中使用 axios 进行 GET 请求。

2. 全局配置 Axios

为了避免每个组件中重复引入 axios，我们可以将其配置为 Vue 的全局实例。可以通过 Vue.prototype 设置全局 axios 实例。

首先在项目的入口文件（如 main.js）中进行配置：

import Vue from 'vue';
import axios from 'axios';// 将 axios 绑定到 Vue 原型上，方便全局使用
Vue.prototype.$axios = axios;// 配置 axios 默认的根路径
axios.defaults.baseURL = 'https://api.example.com';// 可以在此处配置请求头、超时等
axios.defaults.headers.common['Authorization'] = 'Bearer token';
axios.defaults.timeout = 10000;new Vue({render: h => h(App),
}).$mount('#app');

这样，所有的 Vue 组件都可以通过 this.$axios 直接访问 axios，无需再次引入。

3. 配置域名和环境变量

在开发和生产环境中，通常会使用不同的 API 域名。通过配置环境变量，可以轻松管理这些变化。

配置 `.env` 文件

在 Vue 项目根目录下创建 .env 文件，并在其中添加 API 配置：

# .env 文件中设置
VUE_APP_API_URL=https://api.example.com

然后，在 main.js 中使用 process.env.VUE_APP_API_URL 来动态设置 axios 的 baseURL：

axios.defaults.baseURL = process.env.VUE_APP_API_URL;

根据不同的环境，Vue CLI 会自动加载不同的 .env 文件，比如 .env.development 或 .env.production，你可以在其中分别配置开发和生产环境的 API 地址。

4. 错误拦截

在使用 Axios 时，处理请求错误是必不可少的步骤。我们可以通过 axios 的拦截器来统一处理请求和响应的错误。

设置请求和响应拦截器

在 main.js 中添加以下代码，用于设置全局的请求和响应拦截器：

// 添加请求拦截器
axios.interceptors.request.use(config => {// 在请求发送之前做一些事情，比如添加 tokenconst token = localStorage.getItem('token');if (token) {config.headers.Authorization = `Bearer ${token}`;}return config;
}, error => {// 处理请求错误return Promise.reject(error);
});// 添加响应拦截器
axios.interceptors.response.use(response => {// 对响应数据做处理return response;
}, error => {// 处理响应错误if (error.response) {// 根据响应状态码进行错误处理switch (error.response.status) {case 401:console.error('Unauthorized access, redirecting to login');// 可以在此处跳转到登录页或其他处理逻辑break;case 404:console.error('Resource not found');break;default:console.error('An unexpected error occurred');}} else {console.error('Network error, please try again later');}return Promise.reject(error);
});

这样，所有的请求和响应都将被拦截器处理，统一管理错误信息。

5. 在 Vue 中使用 Axios 实例

有时，创建多个 Axios 实例来处理不同的 API 需求会更方便。我们可以创建一个自定义的 Axios 实例并在项目中使用。

import axios from 'axios';// 创建 axios 实例
const apiClient = axios.create({baseURL: process.env.VUE_APP_API_URL,timeout: 5000,headers: {'Content-Type': 'application/json'}
});// 在 Vue 组件中使用
export default {methods: {fetchData() {apiClient.get('/endpoint').then(response => {console.log(response.data);}).catch(error => {console.error(error);});}}
};