如何用d.ts为TypeScript现有类型新增属性？VueRouter扩展失败求助

问题原因 #

你之前的类型扩展方式错误——重新声明VueRouter类会覆盖原有类型定义，而非合并新属性，因此无法解决类型报错。

解决方案 #

方案1：正确扩展VueRouter类型 #

修改src/router.d.ts为以下内容，通过模块扩展机制为原有VueRouter类添加属性：

import 'vue-router'

declare module 'vue-router' {
  export interface VueRouter {
    matcher: any
  }
}

同时检查tsconfig.json的include配置，确保包含src/**/*.d.ts，让TypeScript能识别该类型扩展文件：

{
  "include": ["src/**/*.ts", "src/**/*.d.ts"]
}

方案2：类型断言快速绕过检查 #

如果不想调整类型定义，可直接使用类型断言跳过TypeScript的类型校验：

export function resetRouter() {
  (router as any).matcher = (createRouter() as any).matcher
}

额外建议 #

若使用Vue Router 4及以上版本，官方不推荐直接修改matcher属性，建议使用官方提供的动态路由API（如addRoute、removeRoute）实现路由重置，这种方式更符合规范且无需处理类型问题。

内容的提问来源于stack exchange，提问作者hewc