响应拦截器需在 Axios 层统一将 response.data 的下划线字段递归转为驼峰,因 Vue 响应式不修改属性名,转换必须发生在数据进入组件前;需兼顾嵌套结构、类型映射与防重复转换。

在 Vue 3 中,响应拦截器本身并不直接处理字段命名转换,它属于请求/响应生命周期的网络层逻辑(通常由 Axios 管理),而字段格式转换(如下划线转驼峰)是数据适配层的工作。你需要在拦截器中对 response.data 做统一转换,而不是依赖 Vue 框架本身。
下面分三部分讲清楚怎么做、为什么这么设计、以及关键细节:
响应拦截器里做下划线 → 驼峰转换
Axios 的响应拦截器接收完整响应对象,你可以在 response.data 上递归处理所有键名:
// utils/request.ts
import axios from 'axios'
// 下划线转驼峰(支持嵌套对象、数组)
function toHump(obj: any): any {
if (obj === null || typeof obj !== 'object') return obj
if (Array.isArray(obj)) return obj.map(toHump)
const result: Record<string, any> = {}
for (const [key, value] of Object.entries(obj)) {
const newKey = key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase())
result[newKey] = toHump(value)
}
return result
}
const request = axios.create({ baseURL: '/api' })
request.interceptors.response.use(
response => {
// 只转换业务数据,跳过 status、config 等原生字段
if (response.data && typeof response.data === 'object') {
response.data = toHump(response.data)
}
return response
},
error => Promise.reject(error)
)
export default request为什么不能靠 Vue 响应式系统自动转换?
Vue 3 的响应式基于 Proxy,它只代理对象的读写行为,不修改原始属性名。即使你用 reactive() 包裹一个下划线命名的对象,模板里仍得写 user.user_name,不会变成 user.userName。
命名转换必须发生在数据进入 Vue 状态之前——也就是在请求返回后、存入 ref 或 store 之前完成。
实际使用时要注意的点
-
后端返回结构要稳定:如果接口有时返回
user_name,有时返回userName,转换可能重复或冲突,建议后端统一规范。立即学习“前端免费学习笔记(深入)”;
避免双次转换:如果某些接口已返回驼峰,再进拦截器会被误转(比如
userName→userName不变,但user_Name会变userName)。可加白名单或标记字段跳过。-
TypeScript 类型需同步更新:转换后字段名变了,但 TS 类型还是原接口定义。推荐用工具类型映射:
type SnakeToCamel<S extends string> = S extends `${infer T}_${infer U}` ? `${T}${Capitalize<SnakeToCamel<U>>}` : S type ApiUser = { user_name: string; created_at: string } type User = { [K in keyof ApiUser as SnakeToCamel<K>]: ApiUser[K] } // → { userName: string; createdAt: string } 不要在模板里临时转换:比如
:label="item.user_name | toHump",这既低效又难维护。统一收口到请求层最干净。
这样处理后,你在组件里就能直接用 user.userName、list.createdAt,和 TypeScript 接口、Pinia store、甚至 v-model 都自然对齐。


















