为何在.d.ts文件中需导入Vue？官方要求及无报错疑问

核心原因 #

• 区分模块与全局声明：当你在.d.ts文件中导入Vue时，这个文件会被TypeScript识别为模块，而非全局声明文件。你的类型扩展会被限定在模块作用域内，不会直接修改全局的Vue类型——这能避免大型项目或多插件场景下的类型冲突，防止不同扩展互相覆盖或干扰。
• 保证类型指向正确：Vue的核心类型（比如VueConstructor、Vue接口）都是通过模块导出的。导入Vue后，TypeScript才能明确你是在扩展官方提供的Vue类型，而不是凭空创建一个同名的自定义类型，确保扩展的准确性。

为什么有时候不导入也不报错？ #

这种情况通常依赖项目的全局类型配置：

• 如果你的项目通过vue-shims.d.ts、tsconfig.json的types字段全局引入了Vue类型，TypeScript会自动识别全局的Vue接口，此时不导入也能完成扩展。但这种全局扩展的方式不推荐，一旦多个插件都采用这种写法，很容易出现类型合并冲突。
• 若只是做简单的、不涉及Vue核心类型的声明，可能也不会触发报错，但这属于不规范写法，在复杂场景（比如开发第三方库、多团队协作项目）中会埋下类型隐患。

规范写法示例 #

// 正确：导入Vue，模块级扩展
import Vue from 'vue'

declare module 'vue/types/vue' {
  interface Vue {
    $myPlugin: {
      doSomething(): void
    }
  }
}

这种写法将扩展限定在模块内，类型定义清晰，不会污染全局环境。

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