如何编写无TypeScript定义第三方模块声明以支持任意导入？

当然可以！针对没有TypeScript类型定义的第三方库，你完全可以通过编写模块声明文件（.d.ts）来让TypeScript兼容它，甚至允许导入任意内容。下面我会分两部分详细说明：

一、允许导入任意内容的最简声明 #

如果暂时不想细写类型，只是想让TypeScript不对这个库的导入做任何类型检查，直接把整个模块声明为any类型就可以了。

具体步骤：

1. 在你的项目里创建一个typings目录（或者直接放在src目录下，TypeScript会自动识别.d.ts文件）
2. 新建一个以库名命名的声明文件，比如你的库叫my-untyped-lib，就创建my-untyped-lib.d.ts
3. 在文件里写入以下代码：

declare module 'my-untyped-lib' {
  const lib: any;
  export default lib;
  // 如果需要支持CommonJS的require方式，或者命名导出，添加下面这行
  export = lib;
}

这样之后，不管你用import lib from 'my-untyped-lib'、import * as lib from 'my-untyped-lib'还是const lib = require('my-untyped-lib')，TypeScript都会把lib当作any类型，允许你访问任意属性、调用任意方法，不会抛出类型错误。

二、编写更完善的第三方库类型定义方法 #

如果想让TypeScript提供类型提示和检查，你可以逐步完善类型定义，以下是具体步骤：

1. 先检查是否已有社区维护的类型 #

首先别着急自己写，先看看npm上有没有@types/[库名]包，比如执行：

npm install @types/my-untyped-lib --save-dev

如果这个包存在，直接安装就能用，这是最省心的方式。

2. 从简单到复杂逐步补充类型 #

如果没有社区定义，从最基础的声明开始，慢慢细化：

• 第一步：基础模块声明
  先写一个能让TypeScript识别模块的基础声明，比如先按上面的any版本来，保证代码能正常编译。
• 第二步：补充已知的导出内容
  如果你知道库的具体API，就把对应的类型写进去。比如库默认导出一个函数，接受字符串参数返回数字，还有一个命名导出的版本号：

declare module 'my-untyped-lib' {
  // 默认导出的函数类型
  function processText(text: string): number;
  export default processText;

  // 命名导出的版本号
  export const version: string;

  // 如果有接口类型，也可以定义
  export interface ProcessOptions {
    timeout?: number;
    ignoreCase?: boolean;
  }

  // 补充带参数的重载函数
  function processText(text: string, options: ProcessOptions): number;
}

• 第三步：处理全局变量（如果库有全局暴露的内容）
  有些库会在全局作用域（比如window对象）添加变量，你可以这样声明：

// 在声明文件里添加全局声明
declare global {
  interface Window {
    MyLib: {
      init(config: { apiKey: string }): void;
      getStatus(): string;
    };
  }
}

// 同时声明模块本身的导出
declare module 'my-untyped-lib' {
  export const MyLib: typeof window.MyLib;
}

• 第四步：利用TypeScript高级类型简化定义
  如果库的API比较复杂，你可以用TypeScript的高级类型来简化。比如你有一段JS代码使用了这个库，你可以先在TS文件里用typeof推导类型，再复制到声明文件：

// 示例JS代码
const lib = require('my-untyped-lib');
const result = lib('test', { timeout: 500 });

// 临时在TS文件里推导类型
import lib from 'my-untyped-lib';
type LibFunction = typeof lib;
// 然后把推导出来的类型复制到声明文件
declare module 'my-untyped-lib' {
  type LibFunction = (text: string, options?: { timeout?: number }) => boolean;
  const lib: LibFunction;
  export default lib;
}

3. 测试并完善类型定义 #

写完声明后，在你的TS代码里导入库，尝试调用它的各种API，看看TypeScript是否给出正确的提示和错误，根据实际使用情况逐步调整完善类型。

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