Vue2+Vuetify+TS引入vuetify源码时globals.d.ts识别异常的解决方法

报错根因是TS默认规则会跳过node_modules目录下的非公开类型入口文件，不会自动解析vuetify/src路径下的globals.d.ts全局声明；同时原有shims仅覆盖了vuetify/lib/framework的编译后路径，未适配源码路径的类型解析。

针对直接引入Vuetify TypeScript源码时的编译报错，可按照以下步骤配置实现类型正常识别：

核心配置调整 #

1. 修正tsconfig.json解析规则 #

• 开启compilerOptions.skipLibCheck: true，跳过第三方库内部的类型校验报错，避免Vuetify源码自身的类型不兼容问题干扰项目编译
• 确认compilerOptions.moduleResolution设置为"node"，匹配Vue2 + TS的模块解析模式
• 在include配置数组中新增类型扫描路径，打破TS对node_modules目录的默认过滤规则：

  "include": [
    "src/**/*.ts",
    "src/**/*.d.ts",
    "src/**/*.vue",
    "node_modules/vuetify/src/**/*.d.ts"
  ]
  

• 若compilerOptions.types中配置了固定类型列表，需将"vuetify"加入列表，避免类型被手动排除

2. 补充自定义shims声明文件 #

在项目TS类型扫描覆盖的目录下（一般是src/或src/types/）新建shims-vuetify-src.d.ts，按如下内容编写：

• 第一行显式引用Vuetify源码下的全局声明文件，注意路径需和当前shims文件的实际层级匹配：

  /// <reference path="../node_modules/vuetify/src/globals.d.ts" />
  

  （若shims文件放在src/types/目录下，路径需调整为../../node_modules/vuetify/src/globals.d.ts）
• 新增路径兜底声明，避免TS对vuetify/src下的子路径导入报找不到模块：

  declare module 'vuetify/src/*' {
    import Vue from 'vue'
    const Component: typeof Vue
    export default Component
  }
  

该兜底声明用于覆盖个别未自带完整类型定义的Vuetify源码组件，不会干扰正常的类型推导

验证注意事项 #

• 配置完成后需重启TS语言服务（如VSCode中执行“TypeScript: Restart TS Server”命令），清除旧的类型解析缓存
• 原有的shims-vuetify.d.ts（用于vuetify/lib/framework路径的声明）无需删除，两套路径的类型声明可并行生效，不会产生冲突

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