TypeScript .d.ts声明文件中`export {}`的含义是什么
TypeScript
.d.ts 文件中 export {} 的实际含义 核心本质:划定模块与全局脚本的边界
TypeScript 对文件的作用域判定有一条基础规则:
- 只要一个
.ts/.d.ts文件里没有任何顶层的import或export语句,整个文件的所有声明都会被归入全局作用域,项目内所有代码无需导入就能直接访问这些声明。 - 只要文件存在任意一条顶层的
import或export语句,无论导出的内容是什么,这个文件都会被判定为独立模块,文件内的所有声明默认属于模块私有作用域,只有显式导出的内容才能被外部通过导入使用。
export {} 就是专门用来满足这个判定规则触发条件的语法。
export {} 本身的实际内容
这条语句导出的是一个空的对象字面量,没有任何可供外部导入的具名导出、默认导出成员,本身不携带任何业务层面的有效导出内容。
它的唯一作用就是让文件满足「存在顶层 export」的要求,从根源上避免这个 .d.ts 里的声明意外泄漏到全局作用域,造成命名空间冲突。
自动生成的 .d.ts 为何会附带这条语句
TypeScript 编译器在生成声明文件时,会自动给没有任何对外导出内容的模块源码补上 export {}:
- 如果你的源码文件本身是个没有任何导出的内部模块(比如只定义了供文件内部使用的类型、仅在同文件内调用的工具函数),不加
export {}的话,编译器会把它误判为全局脚本,把本该私有的声明全部暴露到全局。 - 加上这条语句后,文件的模块属性会被正确保留,对应的类型定义不会污染全局命名空间。
常见认知误区
export {}不是给外部预留的空导入入口:虽然语法上允许其他文件写import {} from '对应文件路径',但这种导入没有任何实际业务价值。- 这条语句和全局声明扩展的场景完全相反:如果需要给全局环境补充类型声明(比如给
window扩展自定义属性的类型),绝对不能加export {},否则扩展的类型会被锁在模块作用域里,无法生效到全局环境。
内容的提问来源于stack exchange,提问作者masonCherry
相关产品推荐
相关产品推荐

