TypeScript环境声明中如何覆盖指定默认库类型解决命名冲突？

你可以通过以下两种方式解决冲突，无需禁用整个默认库：

方法一：模块式声明覆盖全局类型 #

将你的声明文件改为模块（添加空导出），然后在全局作用域中重新声明Partial类，直接覆盖内置工具类型：

// app.d.ts
declare global {
  class Partial {
    constructor(data?: { [key: string]: any });
  }
}

// 标记文件为模块，确保全局声明生效
export {};

这种方式会修改全局作用域，让你的Partial类覆盖TS内置的同名工具类型，同时保留所有默认JS/TS类型的补全支持。

方法二：全局作用域直接遮蔽内置类型 #

如果不想将文件改为模块，可以先重新定义内置的Partial类型为never，再声明你的类：

// app.d.ts
// 遮蔽内置的Partial工具类型
type Partial<T> = never;

// 声明你的全局类
declare class Partial {
  constructor(data?: { [key: string]: any });
}

这种方式会消除类型冲突，同时保留默认类型的补全功能，但注意此方法会让TS内置的Partial工具类型在当前作用域不可用，适合不需要使用该工具类型的纯JS库场景。

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