为现有npm模块创建声明文件时遇构造函数错误求助

看起来你遇到的核心问题是TypeScript对模块导出方式的识别和实际CommonJS模块的导出逻辑不匹配，导致编译后的代码尝试访问不存在的.ApiBuilder属性，进而抛出构造函数不存在的错误。我来帮你一步步梳理解决：

问题根源 #

Claudia API Builder作为传统CommonJS模块，它的导出逻辑是直接把ApiBuilder构造函数赋值给module.exports，大致像这样：

function ApiBuilder() { /* 核心逻辑 */ }
// 直接导出构造函数，而非包含ApiBuilder属性的对象
module.exports = ApiBuilder;

而你的声明文件大概率错误使用了命名导出，导致TypeScript编译时生成了claudia_api_builder_1.ApiBuilder这样的代码——但实际模块里根本没有这个属性，自然会报错“不是构造函数”。

正确的声明文件写法 #

针对这种直接导出构造函数的CommonJS模块，我们需要用TypeScript的export =语法来匹配它的导出方式：

declare module 'claudia-api-builder' {
  export class ApiBuilder {
    // 先声明构造函数
    constructor();

    // 补充你需要用到的类方法，比如常见的HTTP路由方法：
    get(path: string, handler: (request: any) => any): this;
    post(path: string, handler: (request: any) => any): this;
    put(path: string, handler: (request: any) => any): this;
    delete(path: string, handler: (request: any) => any): this;

    // 根据模块实际功能，继续补充其他属性或方法
  }

  // 关键：用export = 匹配CommonJS的直接导出逻辑
  export = ApiBuilder;
}

正确的使用方式 #

方式1：CommonJS风格导入 #

import ApiBuilder = require('claudia-api-builder');

const api = new ApiBuilder();
// 后续可以正常调用api.get('/hello', () => 'Hi!')等方法

这样编译后的JavaScript会是你期望的正确形式：

const ApiBuilder = require('claudia-api-builder');
const api = new ApiBuilder();

方式2：ES模块风格导入（需配置tsconfig） #

如果你习惯用import ... from的写法，需要在tsconfig.json里开启esModuleInterop: true，然后这样使用：

import ApiBuilder from 'claudia-api-builder';

const api = new ApiBuilder();

开启esModuleInterop后，TypeScript会自动处理CommonJS模块和ES模块的导出映射，编译后的代码也能正确调用构造函数。

验证修改 #

写完声明文件并调整导入方式后，重新编译代码，应该就不会再出现“ApiBuilder is not a constructor”的报错了。如果还有问题，可以检查下tsconfig.json里的module配置（设置为CommonJS更适配Node.js环境）。

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