TypeScript如何正确为Sequency库扩展方法并完成接口声明合并？

正确的第三方库接口类型扩展步骤 #

1. 新建独立类型声明文件 #

在项目src目录下新建typings/sequency.d.ts声明文件，注意后缀必须为.d.ts，不要和业务实现代码放在同一个普通.ts文件中。

2. 编写模块扩展声明 #

直接在声明文件中写入以下内容，不要加任何顶层import语句：

declare module 'sequency' {
  interface Sequence<T> {
    /**
     * Returns `true` if this sequence is equal to the other sequence or iterable.
     *
     * @param {Sequence | Iterable} other
     * @returns {boolean}
     */
    equals<T>(this: Sequence<T>, other: Sequence<T> | Iterable<T>): boolean
  }
}

3. 调整tsconfig配置 #

修改项目根目录的tsconfig.json，确保自定义声明文件被TypeScript识别：

{
  "compilerOptions": {
    // 保留原有其他配置
    "typeRoots": [
      "node_modules/@types",
      "src/typings"
    ]
  },
  "include": [
    "src/**/*",
    "src/typings/**/*"
  ]
}

4. 重启类型检查服务 #

• 构建流程：重新执行npm run build即可识别新类型
• WebStorm：右下角点击TypeScript图标，选择「Restart TypeScript Service」，或直接重启IDE即可生效

原写法失效原因 #

你之前将模块声明写在了带顶层import/export的普通.ts文件中，TypeScript会将这类文件识别为局部模块，内部的declare module声明仅作用于当前文件范围，无法全局扩展第三方库的公开接口。只有无顶层导入导出的.d.ts文件才会被TypeScript识别为全局类型声明，触发接口合并逻辑。

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