TS2304错误：找不到TransformStream，Socket.IO项目构建失败求助

针对你遇到的Socket.IO项目构建报错（TypeScript找不到TransformStream），以下是几个有效解决办法：

1. 升级@types/node到对应版本 #

TransformStream在Node.js 18.x及以上版本才作为稳定API提供，你需要确保安装的@types/node版本与你的Node.js版本匹配（至少18.x）：

npm install @types/node@^18.0.0 --save-dev
# 或使用yarn
yarn add @types/node@^18.0.0 --dev

2. 调整tsconfig.json配置 #

修改tsconfig.json的compilerOptions，确保包含以下配置：

{
  "compilerOptions": {
    "target": "ES2022",
    "lib": ["ES2022"],
    "moduleResolution": "Node16",
    "types": ["node"]
  }
}

• target设为ES2022及以上，确保TypeScript能识别现代JS API类型
• moduleResolution设为Node16/NodeNext，适配Node.js的ES模块解析规则
• 确认types数组包含node，确保加载Node.js的全局类型

3. 全局声明TransformStream（无需修改node_modules） #

在项目根目录新建types/global.d.ts文件，添加以下声明：

declare type TransformStream<T = any, U = any> = import("stream/web").TransformStream<T, U>;

这个声明会让TypeScript全局识别TransformStream类型，不用修改依赖包的源码。

4. 降级engine.io-parser版本 #

如果是近期升级engine.io-parser导致的问题，可以临时降级到未使用TransformStream的稳定版本（比如5.0.0）：

npm install engine.io-parser@5.0.0 --save
# 或使用yarn
yarn add engine.io-parser@5.0.0

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