项目构建报TS1005错误：parse5类型定义文件需逗号，求解决

问题描述 #

执行npm run prebuild（命令：rimraf dist && tsc）时，出现一系列TS1005编译错误，所有错误均指向node_modules/parse5/dist/index.d.ts文件，提示需要逗号：

[8/8] RUN npm run prebuild:
0.483
0.483 > project@1.0.0 prebuild
0.483 > rimraf dist && tsc
0.483
9.352 node_modules/parse5/dist/index.d.ts(1,15): error TS1005: ',' expected.
9.353 node_modules/parse5/dist/index.d.ts(4,15): error TS1005: ',' expected.
9.353 node_modules/parse5/dist/index.d.ts(6,15): error TS1005: ',' expected.
9.354 node_modules/parse5/dist/index.d.ts(7,42): error TS1005: ',' expected.
9.354 node_modules/parse5/dist/index.d.ts(8,34): error TS1005: ',' expected.
9.354 node_modules/parse5/dist/index.d.ts(16,26): error TS1005: ',' expected.
9.354 node_modules/parse5/dist/index.d.ts(16,64): error TS1005: ',' expected.

问题根源 #

项目使用的TypeScript版本为4.4.3，而parse5（作为jsdom@22.1.0的依赖）的最新类型定义采用了TypeScript 4.5及以上版本才支持的语法（如import type声明），TS4.4无法解析这些语法，导致编译失败。

解决方案 #

提供两种可行方案，可根据项目需求选择：

方案1：降级parse5到兼容版本 #

在package.json的dependencies中添加固定版本的parse5，指定为兼容TS4.4的版本（例如7.1.2）：

{
  "dependencies": {
    // 保留原有依赖...
    "parse5": "7.1.2"
  }
}

执行安装命令更新依赖：

npm install

此操作会强制安装指定版本的parse5，覆盖jsdom引入的高版本依赖。

方案2：升级TypeScript版本 #

将项目的TypeScript版本升级到4.5或更高版本（推荐4.9.x，平衡兼容性与新特性支持），修改package.json中dependencies和devDependencies里的typescript版本：

{
  "dependencies": {
    // 保留原有依赖...
    "typescript": "~4.9.5"
  },
  "devDependencies": {
    // 保留原有依赖...
    "typescript": "~4.9.5"
  }
}

执行安装命令完成升级：

npm install

升级后的TypeScript可以正确解析parse5的类型定义。

额外提示 #

• 确认tsconfig.json中的skipLibCheck已设置为true（当前配置已开启），该选项会跳过第三方库类型文件的检查，可避免类似的跨版本语法兼容问题。
• 若使用Docker构建，修改package.json后需重新构建镜像，或在容器内重新执行npm install更新依赖。

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