TypeScript未文档化保留类型问题咨询

保留类型的来源 #

• TypeScript 内置DOM类型：TypeScript默认会加载lib.dom.d.ts文件，这里面包含了所有浏览器DOM API对应的类型定义，比如你遇到的Location就对应浏览器的window.location类型，这是这类全局保留类型的核心来源。
• Nuxt的间接作用：Nuxt的自动导入机制本身不会新增这类DOM保留类型，但它的TypeScript配置默认会确保TypeScript的DOM类型库被启用，所以会让这些全局类型始终处于可见状态，导致冲突显现。

保留类型的数量 #

TypeScript的DOM全局类型数量庞大，涵盖了从基础的HTMLElement、Document到Location、History等所有浏览器公开API对应的类型，总数在数千个左右，具体数量会随TypeScript版本更新略有调整（比如TS5.x版本中相关类型定义约3000+个）。

快速规避冲突的方法 #

• 给自定义接口添加命名空间：

namespace AppTypes {
  export interface Location {
    id: string,
    myVal: string,
  }
}
// 使用示例
const locationItem: AppTypes.Location = { id: 'loc-001', myVal: 'home' };

• 改用类型别名并替换名称：

export type AppLocation = {
  id: string,
  myVal: string,
}

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