启用skipLibCheck后执行tsc仍检测node_modules并报错

你遇到的错误源于TypeScript版本与@types/node版本不兼容，或是skipLibCheck参数未正确生效，以下是针对性解决方案：

1. 调整版本兼容性 #

这些语法错误（如IterableIterator、方法参数语法报错）通常是因为当前TypeScript版本不支持@types/node新版本的语法特性：

• 先查看当前TypeScript版本：

  tsc -v
  

• 确保@types/node版本与TS版本匹配：比如TS 4.x对应@types/node@14~18，TS 5.x支持更高版本的@types/node。
• 执行版本调整：
  • 升级TypeScript到兼容版本：

    npm install typescript@latest --save-dev
    

  • 或降级@types/node到适配当前TS的版本（以16版本为例）：

    npm install @types/node@16 --save-dev
    

2. 确认skipLibCheck参数生效 #

检查tsconfig.json，避免配置覆盖命令行参数：

• 确保skipLibCheck未被设为false，若配置文件中有该字段，改为true：

  {
    "compilerOptions": {
      "skipLibCheck": true
    }
  }
  

• 检查exclude字段包含node_modules，避免TypeScript编译依赖包内的文件：

  {
    "exclude": ["node_modules"]
  }
  

3. 重置依赖缓存 #

依赖缓存异常也可能引发此类问题，执行以下步骤重新安装依赖：

rm -rf node_modules package-lock.json
npm install

你遇到的错误信息： #

node_modules/@types/node/util.d.ts:1631:41 - error TS1005: 应为'('。

1631         keys(): IterableIterator<string>;
                                             ~

node_modules/@types/node/util.d.ts:1646:17 - error TS1005: 应为','。

1646         set(name: string, value: string): void;
                     ~

node_modules/@types/node/util.d.ts:1646:32 - error TS1005: 应为','。

1646         set(name: string, value: string): void;
                                    ~

node_modules/@types/node/util.d.ts:1646:41 - error TS1005: 应为';'。

1646         set(name: string, value: string): void;
                                             ~

node_modules/@types/node/util.d.ts:1646:47 - error TS1109: 应为表达式。

1646         set(name: string, value: string): void;
                                                   ~

node_modules/@types/node/util.d.ts:1650:17 - error TS1005: 应为';'。

1650         values(): IterableIterator<string>;
                     ~

node_modules/@types/node/util.d.ts:1650:43 - error TS1005: 应为'('。

1650         values(): IterableIterator<string>;
                                               ~

node_modules/@types/node/util.d.ts:1654:26 - error TS1005: 应为';'。

1654         [Symbol.iterator]: typeof MIMEParams.prototype.entries;
                              ~

node_modules/@types/node/util.d.ts:1656:1 - error TS1128: 应为声明或语句。

1656 }
     ~

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