
Vite 的 resolve.alias 仅作用于模块导入(如 import),不参与 HTTP 请求路径解析;API 请求应通过 server.proxy 配合环境变量(如 import.meta.env.VITE_APP_API_URL)实现开发/生产环境的路径统一管理。
vite 的 `resolve.alias` 仅作用于模块导入(如 `import`),不参与 http 请求路径解析;api 请求应通过 `server.proxy` 配合环境变量(如 `import.meta.env.vite_app_api_url`)实现开发/生产环境的路径统一管理。
在 Vite 项目中,常有人误以为 resolve.alias(如 '@api': '/api')能像模块路径一样被 axios.post('@api/login') 自动解析为实际请求地址——但这是对 Vite 构建机制的根本误解。别名(alias)仅在编译期用于重写 import 语句的模块路径,例如 import api from '@api/utils';而 axios.post() 中的字符串是运行时由浏览器发起的真实 HTTP 请求路径,Vite 完全不会处理或替换该字符串中的任何别名。因此 @api/login 会被原样发送为 http://localhost:5173/@api/login,导致 404。
✅ 正确做法:用环境变量 + 代理协同工作
Vite 提供了开箱即用的环境变量机制,以 VITE_ 开头的变量会自动注入到客户端代码中(import.meta.env)。你只需在项目根目录创建 .env 文件:
# .env(开发环境) VITE_APP_API_URL=/api
# .env.production(生产环境) VITE_APP_API_URL=https://api.yourdomain.com
然后在组件中使用:
// src/composables/useAuth.ts
import axios from 'axios';
const API_BASE = import.meta.env.VITE_APP_API_URL;
export const login = (credentials: { username: string; password: string }) => {
return axios.post(`${API_BASE}/login`, credentials)
.then(res => {
console.log('Login success:', res.data);
return res.data;
})
.catch(err => {
console.error('Login failed:', err.response?.data || err.message);
throw err;
});
};
同时,确保 vite.config.js 中的 server.proxy 配置与 VITE_APP_API_URL 的值保持一致(开发时为 /api):
server: {
proxy: {
'/api': {
target: 'http://apiUrlForDevelopment', // 实际后端地址
changeOrigin: true,
rewrite: (path) => path.replace(/^\/api/, ''),
}
}
}
⚠️ 注意事项:
- 环境变量名必须以
VITE_开头,否则不会暴露给前端代码; - 生产构建时,
import.meta.env.VITE_APP_API_URL会被静态替换为.env.production中的值(非运行时读取),确保安全性与确定性; - 不要混用别名与请求路径——
@api只适合导入本地 JS 模块(如import { loginApi } from '@api/endpoints'),而非构造 URL 字符串; - 若需统一管理所有 API 调用,建议封装成自定义 Hook 或 Service 类,并在其中注入基础 URL,便于后续切换 Axios 实例或添加拦截器。
通过环境变量驱动 API 基础路径,配合 Vite 的代理能力,既能实现开发时的跨域转发,又可保障生产环境灵活部署,这才是现代前端工程中 API 配置的最佳实践。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











