如何在TypeScript中扩展Node.js的fs.WriteStream并生成临时文件？

你遇到的是TypeScript类型系统与Node.js内置流构造函数之间的类型兼容问题，错误核心是传给super()的临时文件路径字符串，没有通过TypeScript的严格类型检查。

错误原因分析 #

虽然tmp.fileSync().name返回的是合法的文件路径字符串，但在TypeScript的类型定义中，fs.WriteStream构造函数的第一个参数是PathLike类型（涵盖string、Buffer和URL），理论上字符串是兼容的。问题出在继承Node.js内置类时的构造函数类型检查限制，或是你的@types/node版本与代码存在兼容性差异，导致TypeScript无法自动推断路径字符串的兼容类型。

解决方案 #

这里提供两种简单有效的修复方式：

1. 显式类型断言

直接将临时路径断言为PathLike类型，明确告知TypeScript该字符串符合构造函数的参数要求：

import fs = require('fs');
import tmp = require('tmp');

export class TmpWriteStream extends fs.WriteStream {
  constructor() {
    // 用类型断言绕过类型检查
    super(tmp.fileSync().name as fs.PathLike);
    // 初始化其他属性
  }
}

2. 提前存储路径并标注类型

如果类型断言仍不生效，可以先将临时路径存入变量并明确标注类型，再传给super()：

import fs = require('fs');
import tmp = require('tmp');

export class TmpWriteStream extends fs.WriteStream {
  constructor() {
    const tmpPath: fs.PathLike = tmp.fileSync().name;
    super(tmpPath);
    // 初始化其他属性
  }
}

额外优化：临时文件自动清理

顺便提一句，tmp库创建的临时文件默认不会自动删除，你可以在流关闭时添加清理逻辑，避免文件残留：

import fs = require('fs');
import tmp = require('tmp');
import { promisify } from 'util';

const unlink = promisify(fs.unlink);

export class TmpWriteStream extends fs.WriteStream {
  private readonly tmpPath: fs.PathLike;

  constructor() {
    const tmpObj = tmp.fileSync();
    super(tmpObj.name as fs.PathLike);
    this.tmpPath = tmpObj.name;

    // 流关闭时自动删除临时文件
    this.on('close', async () => {
      try {
        await unlink(this.tmpPath);
      } catch (err) {
        console.error('删除临时文件失败:', err);
      }
    });
  }
}

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