如何理解Vuex文档？关于declaration file的定义及相关疑问

• Declaration File（声明文件）是什么：
  这是TypeScript专属的文件，后缀一般为.d.ts。它的核心作用是给无类型信息的代码（比如原生JavaScript库、或者TypeScript里需要扩展的内置类型）补充类型定义，让TypeScript编译器能识别这些代码的类型，避免不必要的类型报错。比如你看到的Vuex文档场景，就是要通过声明文件扩展Vue的ComponentCustomProperties，让TypeScript能识别Vue实例上的$store属性。

• 是否就是创建Shim文件：
  没错，Vue项目里常见的shims-vue.d.ts、shims-tsx.d.ts这类文件就属于声明文件的范畴。这类文件被称为“shim”，是因为它们用来“适配”TypeScript对非标准TypeScript文件（比如.vue单文件组件）的识别，本质就是声明文件在Vue场景下的具体应用。文档里说的添加declaration file，就是创建这类.d.ts文件来完成类型扩展。

• 术语说明的参考渠道：

  • TypeScript官方文档有专门章节讲解声明文件，从基础概念到编写规范都有详细说明，能帮你系统理解这类文件的作用和用法。
  • Vue官方的TypeScript支持文档，会结合Vue的实际开发场景，解释声明文件（包括shim文件）的具体使用方式，比如如何扩展Vue实例类型、处理组件类型等。

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