npm run build构建失败：TypeScript与lodash类型定义兼容性问题

问题概述 #

执行npm run build（实际执行命令为tsc && react-scripts build）时触发3个TS1005错误，报错位置集中在node_modules/@types/lodash/common/object.d.ts的1026、1031、1041行，提示缺少?符号，核心原因是TypeScript版本与@types/lodash类型定义版本不兼容。

涉及版本信息：

• TypeScript：4.5.2
• lodash：4.17.21

错误根源 #

@types/lodash的最新版本使用了TypeScript 4.7才正式引入的模板字符串类型约束语法（即${infer N extends number}这种写法），而你的TS版本是4.5.2，不支持该语法，导致类型解析失败抛出错误。

可行解决方案 #

方案1：降级@types/lodash到兼容TS4.5的版本 #

安装适配TS4.5的类型定义稳定版本，比如@types/lodash@4.14.182（该版本是最后一批兼容TS4.5的@types/lodash版本之一）：

npm install @types/lodash@4.14.182 --save-dev

方案2：升级TypeScript到支持该语法的版本 #

将TypeScript版本升级到4.7或更高（推荐直接升级到稳定的5.x系列）：

npm install typescript@^5.0.0 --save-dev

注意：升级TS后需要确认项目中其他依赖（比如react-scripts）是否兼容新版本TypeScript，避免引发其他连锁问题。

方案3：临时跳过第三方库类型检查（不推荐） #

如果只是需要临时完成构建，可以在tsconfig.json中开启skipLibCheck选项，跳过对第三方库的类型检查：

{
  "compilerOptions": {
    // 保留原有其他配置...
    "skipLibCheck": true
  }
}

该方案仅能临时绕过问题，并未从根本解决类型兼容性问题，长期维护不建议使用。

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