如何仅引入TypeScript类型定义而不导入对应第三方库完整模块

方案1：使用类型仅导入（推荐，TS 3.8+支持） #

TypeScript 3.8及以上版本提供的import type语法只会引入类型定义，编译后会被完全抹除，不会生成任何实际的导入代码，不会触发运行时逻辑。
操作步骤：

• 执行import type SweetAlert2 from 'sweetalert2'引入类型
• 针对全局挂载的SweetAlert2实例补充全局类型声明，示例如下：

// 可以写在任意TS文件或者全局.d.ts声明文件中
declare global {
  interface Window {
    Swal: typeof SweetAlert2;
  }
}
// 后续直接使用window.Swal即可获得完整类型提示

方案2：全局类型声明（无需写任何导入语句） #

如果希望完全不出现导入相关代码，可以通过全局声明文件实现全项目的类型识别：

• 首先在项目根目录新增global.d.ts声明文件，写入以下内容：

declare const Swal: typeof import('sweetalert2').default;

• （可选）如果类型未生效，可在tsconfig.json的compilerOptions中补充类型引用配置：

{
  "compilerOptions": {
    // 确保包含你的声明文件目录，以及node_modules的类型目录
    "typeRoots": ["./node_modules/@types", "./"],
    "types": ["sweetalert2"]
  }
}

配置完成后所有TS文件中直接使用Swal即可获得智能提示与类型校验，完全不会生成任何运行时代码。 #

注意事项 #

• 不要使用普通import Swal from 'sweetalert2'语法，这类普通导入会被保留到编译后的JS代码中，触发你不需要的额外加载逻辑
• 如果你使用的TS版本低于3.8，仅可使用方案2的typeof import()类型查询语法实现类型引用，该语法在所有TS 2.9+版本中都支持

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