Node.js中Array扩展类型正常但运行报错，求导入方案指引

核心原因 #

VS Code的智能提示能识别新增属性，是因为typeRoots配置让TypeScript找到了类型声明，但运行时你的扩展代码根本没被执行——JS环境里Array原型上并没有这些新增属性/方法，自然会报错。

具体解决步骤 #

1. 拆分类型与实现（可选但更规范） #

把原文件拆成两个文件，分开维护类型和逻辑：

• 类型声明文件：array.extensions.d.ts（只保留类型定义）

export {};

declare global {
  interface Array<T> {
    remove(o: T): Array<T>;
    isEmpty: boolean;
    isNotEmpty: boolean;
    first: T;
    last: T;
  }
}

• 实现文件：array.extensions.ts（放原型扩展的JS逻辑）

Object.defineProperty(Array.prototype, 'isEmpty', {
  configurable: true,
  get() {
    return this.length === 0;
  },
});

Object.defineProperty(Array.prototype, 'isNotEmpty', {
  configurable: true,
  get() {
    return this.length > 0;
  },
});

Object.defineProperty(Array.prototype, 'first', {
  configurable: true,
  get() {
    return this[0];
  },
});

Object.defineProperty(Array.prototype, 'last', {
  configurable: true,
  get() {
    return this[this.length - 1];
  },
});

Array.prototype.remove = function <T>(o: T): Array<T> {
  const i = this.indexOf(o);
  if (i > -1) {
    return this.splice(i, 1) as Array<T>;
  }
  return [];
};

2. 让扩展代码在运行时生效 #

必须让扩展代码被执行一次，才能给Array原型挂上新增内容，有两种方式：

• 全局导入（推荐）：在项目入口文件（比如src/index.ts）最顶部导入扩展文件：

  import './shared/extensions/array.extensions';
  

  项目启动时就会执行这段代码，全局生效。
• 按需导入：如果只有部分文件用到，可以在使用前导入，但容易遗漏，不推荐。

3. 检查tsconfig.json配置 #

确保typeRoots和include配置正确，TypeScript能找到类型声明：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./src/shared/extensions"],
    "include": ["src/**/*"]
  }
}

注意typeRoots要保留node_modules/@types，别丢了默认类型。

验证 #

重启项目后执行console.log('isEmpty', ['x', 'y', 'z'].isEmpty);，应该能正常输出isEmpty false，不会再报错。

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