Object.groupBy 类型推断错误通常是因为 TypeScript 版本过低或 tsconfig.json 中未启用 ES2024 库支持。升级 TypeScript 到 5.3 以上并在 lib 配置中添加 es2024 可解决大部分编译报错。

命令速用版

若项目使用 TypeScript，直接修改配置文件即可修复类型识别问题。

// tsconfig.json
{
  "compilerOptions": {
    "lib": ["es2024", "dom"],
    "target": "es2024"
  }
}

若无法升级 target，至少确保 lib 数组中包含 es2024 或 esnext。

为什么会这样

Object.groupBy 是 ECMAScript 2024 新增标准方法，旧版 TypeScript 类型定义中不包含该接口。

编译器无法识别新方法会导致类型推断为 any 或直接报错 Property 'groupBy' does not exist。即使编译器通过，若运行环境不支持，代码执行时会抛出 TypeError。

分步处理

第一步：检查 TypeScript 版本。

在终端执行 tsc `--version`，若版本低于 5.3，执行 npm install -D typescript@latest 升级。

第二步：修改 tsconfig.json 配置。

找到 compilerOptions.lib 字段，添加 es2024。若不存在 lib 字段，手动创建并填入 ["es2024", "dom"]。

第三步：处理运行时兼容性。

若目标环境为 Node.js 20 及以下或旧版浏览器，需安装 core-js 或 core-js-pure 并引入 polyfill，否则运行时会报错。

怎么验证是否生效

执行 tsc `--noEmit` 命令，若终端无类型错误输出，说明编译期类型推断已修复。

在代码中调用 Object.groupBy 并打印结果，若控制台未抛出 TypeError 且返回预期对象结构，说明运行时支持正常。

常见坑

仅修改 TypeScript 配置而不处理运行环境会导致构建成功但运行崩溃。

部分构建工具如 Vite 或 Webpack 可能默认屏蔽新语法，需检查 babel 或 swc 配置是否支持 ES2024 语法转换。

常见问题

Node.js 多少版本支持 Object.groupBy？

Node.js 21.0.0 及以上版本原生支持，低于该版本需使用 Polyfill。

无法升级 TypeScript 版本怎么办？

可在项目中手动声明类型定义文件，补充 ObjectConstructor 接口中的 groupBy 方法签名。

Object.groupBy 和 lodash groupBy 有什么区别？

Object.groupBy 是原生标准方法，无需额外依赖，但功能较 lodash 简单，不支持深层路径键名提取。