安装winston-elasticsearch后执行tsc --build报TS5023错误求助

云上老周

2026-7-16

问题解决：tsc --build 报 Unknown compiler option '--build'

问题原因

报错提示--build是未知选项，说明当前执行的tsc版本低于TypeScript 3.0（--build是3.0版本新增的功能）。虽然你本地声明的TS版本是5.0.4，但安装winston-elasticsearch后，依赖链中可能引入了低版本TypeScript，导致实际调用的tsc被旧版本覆盖。

解决步骤

确认当前执行的tsc版本
执行以下命令，查看实际调用的tsc版本：
```
npx tsc -v
```
如果输出不是5.0.4，说明调用的不是项目指定的TS版本。
确保项目本地安装指定版本的TypeScript
把TS 5.0.4安装到项目开发依赖，确保脚本优先调用本地版本：
```
npm install typescript@5.0.4 --save-dev
```
排查并修复依赖版本冲突
查看所有依赖引入的TypeScript版本，找出低版本来源：
```
npm ls typescript
```
如果发现winston-elasticsearch或其依赖引入了旧版TS，强制项目统一使用5.0.4版本：
- 若使用npm 8+，在package.json中添加overrides：
```
"overrides": {
  "typescript": "5.0.4"
}
```
- 若使用yarn，添加resolutions：
```
"resolutions": {
  "typescript": "5.0.4"
}
```
添加后重新执行npm install或yarn install。
验证修复效果
再次执行构建命令：
```
npx tsc --build
```
或者如果package.json的scripts中配置了"build": "tsc --build"，直接运行：
```
npm run build
```