TypeScript突然忽略.d.ts文件，Vue自定义类型扩展失效求助

看起来你遇到的是TypeScript无法识别自定义.d.ts类型声明的问题，之前正常工作突然报错，大概率是类型扫描配置或者缓存的问题，以下是一步步的排查和解决方法：

1. 检查tsconfig.json的扫描配置 #

TypeScript需要明确知道要加载哪些类型文件，首先确认你的tsconfig.json里的include字段包含了自定义.d.ts所在的目录。比如如果这些文件放在src/目录下或者子目录里，include应该包含对应的路径：

{
  "compilerOptions": {
    // 其他配置...
  },
  "include": [
    "src/**/*.ts",
    "src/**/*.d.ts", // 确保自定义类型文件被扫描
    "src/**/*.vue"
  ]
}

如果你的.d.ts文件在项目根目录的types/文件夹下，记得把types/**/*.d.ts也加入include。

另外，如果你配置了typeRoots字段，要确保它包含你的自定义类型目录，否则TypeScript只会默认扫描node_modules/@types：

"compilerOptions": {
  "typeRoots": [
    "./node_modules/@types",
    "./src/types" // 你的自定义类型所在目录
  ]
}

注意：如果没有设置typeRoots，TypeScript会自动扫描node_modules/@types，但自定义的.d.ts需要通过include来纳入扫描范围。

2. 确认类型声明的正确性 #

检查你的.d.ts文件有没有语法错误，比如模块声明的路径是否正确：

// vue-analytics.d.ts 正确写法
declare module 'vue/types/vue' {
  interface Vue {
    $ga: any
  }
}

要确保'vue/types/vue'这个模块路径完全正确，拼写错误会导致TypeScript无法合并这个接口。

3. 清除TypeScript缓存 #

有时候TypeScript的缓存会导致类型没有更新，尤其是在没有修改代码但环境有变化的情况下：

• 如果是Vue CLI项目，可以删除node_modules/.cache目录；
• 直接运行npx tsc --clean清除编译缓存；
• 重启你的IDE（比如VS Code），有时候IDE的类型服务也会缓存旧的类型信息。

4. 检查是否有排除规则冲突 #

确认tsconfig.json的exclude字段没有包含你的.d.ts文件所在的目录，比如如果exclude里有src/types，那TypeScript会忽略这些文件，自然无法加载类型。

为什么直接修改node_modules里的类型文件有效？ #

因为node_modules/@types是TypeScript默认的类型扫描目录，直接修改这里的文件会被TypeScript自动识别，但这种做法不可取——每次安装依赖都会覆盖修改，所以一定要通过自定义.d.ts+正确配置的方式来扩展类型。

如果以上步骤都试过还是不行，可以试试把所有自定义的Vue类型扩展合并到一个文件里（比如src/vue-shim.d.ts），有时候分散的文件可能因为扫描顺序问题导致合并失败。

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