TypeScript 模块扩展

TypeScript 支持你"扩展现有模块的类型定义 ",这称为 模块扩展(Module Augmentation),常见于:

  • 为第三方库添加缺失的类型定义

  • 扩展现有模块的接口或类型

  • 使用 declare module 'xxx' 扩展模块内容

❗ 为什么要"放在模块中"?

如果你写了 declare module 'xxx' {...}:

  • ✅ 如果这个文件是一个模块(有 export {}),那么你写的东西是"扩展"原模块。
  • ❌ 如果这个文件是 script(无 import/export),那它就是"声明一个全新的模块",会覆盖原来的类型!

✅ 示例:正确扩展模块

typescript 复制代码
// example.d.ts
export {}; // 👈 让这个文件成为模块!

declare module 'vue' {
  interface ComponentCustomProperties {
    $trans: (key: string) => string;
  }
}

✅ 这样,TypeScript 会将你的扩展 合并 到 'vue' 原来的类型中。


❌ 示例:错误用法(会覆盖原模块)

typescript 复制代码
// example.d.ts
// ❌ 没有 export/import,这会变成全局 script

declare module 'vue' {
  interface ComponentCustomProperties {
    $trans: (key: string) => string;
  }
}

这样会导致 TypeScript 认为你声明的是整个模块的完整定义 ,原有类型就会被完全替换掉,造成类型错误或丢失。


✅ 总结一句话:

如果你想扩展 TypeScript 中的已有模块,记得把扩展代码放在一个模块文件里(至少写个 export {}),否则它就不是"扩展",而是"覆盖"了!

相关推荐
FRing0310 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷10 小时前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
4cos9011 小时前
pi学习笔记-AgentLoop
typescript
Java小卷11 小时前
面向 Schema 编程,Vue 3 页面级渲染引擎!强大的第三方 UI 适配与扩展(一)
vue.js·低代码
鹿鹿鹿鹿isNotDefined11 小时前
布局更新后,canvas 重新绘制,出现了只持续一帧的闪烁?!
前端·javascript·vue.js
闲来没事抠鼻屎11 小时前
PDF导出与网页打印控件:两条交付路线怎么选
vue.js
FRing0315 小时前
vue2干货总结10(json-server、vant-ui、postcss插件、axios二次封装、图形验证码、toast轻提示)
开发语言·前端·vue.js·ui·json·vue2·postcss
程序员大阳15 小时前
副队长ES6+教程(5)--模板字符串
javascript·vue.js·es6·模板字符串
程序员大阳15 小时前
副队长ES6+教程(4)--拓展运算符
javascript·vue.js·es6·收集·拓展运算符·展开
徐小夕16 小时前
CADViewer-Skill:让 Agent 原生支持 DWG 解析、可视化图统计、图纸导出
前端·vue.js·github