typescript 中扩展全局类型须用无 export/import 的 .d.ts 文件，将 interface 扩展写在 declare global { } 内，如扩展 window.chart 或 array.safeget，仅声明类型不实现，运行时需单独补丁。

在 TypeScript 中，为挂载到全局对象（如 window、globalThis）的第三方 JS 库补充类型，最直接的方式是通过全局接口扩展——它不依赖 import，编译器自动识别，且能自然覆盖运行时已存在的行为。

必须用无 export 的 .d.ts 文件

扩展声明只能写在**没有 export 或 import 语句的 .d.ts 文件中**（例如 src/types/global.d.ts）。一旦文件含 export，TS 就将其视为模块作用域，declare global 将失效，扩展无法合并到全局环境。

• ✅ 正确：文件纯声明，无任何 export/import
• ❌ 错误：哪怕只有一行 export {};，整个 declare global 块就变成模块内声明，对 window 等无效

用 declare global 包裹接口扩展

所有要增强全局对象或内置类型的定义，必须放在 declare global { } 块内。不能直接写 interface Window { ... }，否则 TS 报错“无法合并接口”。

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

• 扩展全局变量：如 CDN 引入的 Chart、$、mySDK
• 扩展内置接口：如 Array、String、Date
• 注意：只写类型，不写实现。例如给 Array 加 safeGet 方法，仅声明签名，运行时需另行打补丁

常见扩展示例

比如通过 script 标签引入 Chart.js，它会挂载 window.Chart：

declare global {
  interface Window {
    Chart: typeof import('chart.js');
  }
}

再比如为所有数组添加安全取值能力：

declare global {
  interface Array<t> {
    safeGet(index: number): T | undefined;
  }
}</t>

对应运行时实现需单独写在 .ts 文件中，并确保被导入执行（如 polyfills/array-safe-get.ts）。

避坑要点

• 未声明的全局变量要先 declare const myLib: {...}，不能只在 interface 里提它
• 多个 declare global 块可共存，TS 自动合并同名接口（如都扩展 Window）
• 避免重写原生方法名（如 push、map），防止类型与运行时不一致
• 验证是否生效：在任意 .ts 文件中输入 window.，看编辑器是否提示你加的属性；或用 tsc --noEmit 检查报错

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南