TypeScript动态路由接口需建模后端返回的JSON结构，核心字段包括path、name、component（字符串标识）、meta及递归children；配套import.meta.glob实现组件路径到懒加载函数的安全映射，并通过类型守卫强化路由守卫中的类型安全。
在 TypeScript 中定义动态路由接口，核心是为后端返回的路由配置数据建模，确保类型安全、可推导、易维护。不是写 Vue Router 的类型，而是描述“从服务端拉回来的那批菜单+路由元信息”该长什么样。
明确接口用途：描述后端返回的路由结构
动态路由通常由后端返回 JSON 数据，前端解析后调用 router.addRoute() 或生成菜单。这个 JSON 的结构需用 TypeScript 接口精确约束：
- 每个路由项至少包含
path、name、component（或其标识）、meta等字段 -
component一般不传真实组件（前端无法序列化），而是传路径字符串（如"system/user"）或组件名（如"UserManage"），前端再映射为懒加载函数 -
children字段需递归定义，支持多级嵌套路由
基础接口定义示例
以下是一个生产环境常用、兼顾权限与菜单展示的接口定义：
src/types/router.ts
立即学习“前端免费学习笔记（深入）”；
typescript-advanced-types
下载
精通 TypeScript 高级类型系统，包括泛型、条件类型、映射类型、模板字面量类型与工具类型，用于构建类型安全的应用。在实现复杂类型逻辑、创建可复用类型工具
export interface RouteMeta {
title?: string;
icon?: string;
roles?: string[];
requiresAuth?: boolean;
hideInMenu?: boolean;
order?: number;
}
export interface BackendRoute {
path: string;
name: string;
component?: string; // 后端返回的组件标识，如 "dashboard/analysis"
redirect?: string;
meta: RouteMeta;
children?: BackendRoute[];
}
配套：组件路径到懒加载函数的映射逻辑
后端只给字符串，前端要转成 () => import(...)。建议封装一个安全的解析函数：
- 使用
import.meta.glob预扫描所有views下的 .vue 文件 - 将后端返回的
component: "user/list"映射为import('@/views/user/List.vue') - 类型上可加一层校验，避免路径拼错导致运行时报错
例如：
// utils/route-loader.ts
const views = import.meta.glob('@/views/**/*.{vue,ts}');
export function loadComponent(compPath: string): () => Promise<any> {
const normalized = compPath.replace(/^[./]+/, '').replace(/\//g, '/');
const key = `@/views/${normalized}.vue`;
if (views[key]) return views[key] as () => Promise<any>;
throw new Error(`Route component not found: ${key}`);
}
这样在构建路由时就能类型安全地调用：component: loadComponent(route.component)。
配合路由守卫做类型收束
在 router.beforeEach 中处理动态路由时，可以利用类型守卫进一步缩小 to.meta 的范围：
function hasRequiredRoles(meta: RouteMeta): meta is RouteMeta & { roles: string[] } {
return Array.isArray(meta.roles) && meta.roles.length > 0;
}
router.beforeEach((to) => {
if (hasRequiredRoles(to.meta)) {
// 此处 to.meta.roles 类型已确定为 string[]
if (!currentUserRoles.some(r => to.meta.roles.includes(r))) {
return '/403';
}
}
});
