如何保留生成声明文件中第三方库的全局类型导入？

你在为自研库生成声明文件时遇到一个问题：从thirdpartylib导入的MyInterface类型，因为它是第三方库模块内定义的全局类型，导致最终生成的声明文件里导入语句被剥离，只留下类型引用却没有对应的导入，进而引发类型查找错误。

可行的解决方法 #

1. 显式绑定类型到模块 #

在你的源码文件中，通过重新导出类型或者创建内部类型引用，让TypeScript识别到该类型是模块的依赖项，从而保留导入语句：

// 你的源码文件
import type { MyInterface } from 'thirdpartylib';

// 方案A：如果你的库需要对外暴露该类型，直接导出
export type { MyInterface };

// 方案B：如果不需要对外暴露，创建内部类型绑定以保留导入
type _ForceKeepImport = MyInterface;

生成的声明文件会保留对应的import type语句，因为TypeScript检测到模块对该类型的明确依赖。

2. 启用verbatimModuleSyntax编译选项 #

在项目的tsconfig.json中启用verbatimModuleSyntax配置，它会严格保留所有import/export语句，包括仅用于类型的导入：

{
  "compilerOptions": {
    "verbatimModuleSyntax": true,
    // 其他编译配置...
  }
}

启用后，即使MyInterface是全局类型，TypeScript也不会自动剥离对应的导入语句，确保声明文件的依赖关系正确。

3. 直接引用全局类型（不推荐） #

由于MyInterface是全局类型，你可以直接在代码中使用它而无需导入，但前提是确保thirdpartylib的类型已被加载。这种方法会让类型依赖变得模糊，其他开发者使用你的库时可能需要手动引入thirdpartylib的类型定义，因此不建议在库开发场景中使用。

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