在Node.js+TypeScript+Architect项目中如何声明全局Error类型？

我采用Node.js+TypeScript+Architect架构部署Lambda函数，通过Architect的TypeScript插件编译代码。当前遇到TypeScript类型错误：TS读取的是VS Code自带的lib.es5.d.ts中的Error类型，该类型构造函数仅支持message单个参数，也没有options接口定义，但Node.js原生Error类支持带options参数的构造签名，导致我使用Node.js的Error写法时触发TS报错。

已知两种可能方案但存在局限：

• 声明全局Error类型：受限于Architect自身的TS编译插件，无法实现声明覆盖
• 自定义Error类：希望找到更贴合原生用法的最优解

1. 调整TypeScript配置适配Node.js环境 #

在项目根目录的tsconfig.json中明确指定目标环境、依赖Lib，并引入Node.js类型定义：

{
  "compilerOptions": {
    "target": "ES2020", // 匹配Node.js支持Error options参数的版本
    "lib": ["ES2020"],
    "types": ["node"],
    "module": "CommonJS",
    "strict": true
  },
  "include": ["src/**/*"]
}

同时安装Node.js类型依赖：

npm install @types/node --save-dev

Architect的TS插件会读取项目的tsconfig.json配置，让TS使用Node.js对应的Error类型定义，替代默认的ES5版本。

2. 类型断言临时绕过（应急方案） #

若暂时无法修改配置，可通过类型断言强制使用Node.js的Error构造签名：

const error = new (Error as { new(message: string, options: { cause: unknown }): Error })('请求失败', { cause: new Error('数据库连接异常') });
throw error;

该方式仅适合临时场景，不推荐长期使用。

3. 自定义类型扩展补充Error接口 #

创建类型扩展文件（如types/global.d.ts），手动补充Error的构造签名：

declare global {
  interface ErrorConstructor {
    new(message?: string, options?: ErrorOptions): Error;
  }
  interface ErrorOptions {
    cause?: unknown;
  }
}

export {};

然后在tsconfig.json中包含该文件：

{
  "include": ["src/**/*", "types/**/*"]
}

这种方式可手动扩展全局Error类型，适配Node.js的接口规范。

如果Architect插件强制使用特定TS版本或配置，可查阅插件文档确认是否支持自定义tsconfig路径，或通过环境变量指定配置文件位置。

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