.svg模块与全局对象共存时的TypeScript类型定义冲突问题

核心原因：TypeScript对全局类型文件和模块类型文件的处理逻辑差异 #

TypeScript将.d.ts文件分为两类，不同类型的文件在类型声明的作用范围、合并规则上有本质区别：

• 未添加export {}时（全局类型文件）

  • SVG导入正常：此时文件属于全局作用域，你定义的declare module "*.svg"是全局模块声明，会被TS应用到整个项目的所有模块中，所以.svg文件的导入类型能被正确识别。
  • Window属性无法推断：如果直接在全局文件里写interface Window { /* 扩展属性 */ }，TS的全局接口合并机制可能因为以下原因失效：
    1. 项目中存在其他模块内的Window扩展，优先级高于全局文件的声明；
    2. 部分TS配置（如moduleResolution设置）会导致全局类型的合并未被自动触发，模块代码无法读取到全局扩展的Window属性。

• 添加export {}时（模块类型文件）

  • Window属性推断正常：此时文件成为模块，你需要用declare global { interface Window { /* 扩展属性 */ } }包裹Window扩展，这种写法会强制将声明合并到全局作用域，TS能正确识别扩展后的Window类型。
  • SVG导入失效：模块内的declare module "*.svg"是模块级别的局部声明，仅在当前.d.ts文件所在的模块内生效，项目中其他模块导入.svg时无法读取到这个类型定义，因此类型推断失效。

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