tsconfig/bases项目中的ES特性兼容性问题解析

关于tsconfig/recommended配置的定位

tsconfig/bases项目提供的recommended配置主要聚焦于TypeScript的严格类型检查选项，而非JavaScript运行时环境的特性支持。这个设计决策体现了TypeScript配置的模块化理念，让开发者可以灵活组合不同的配置集。

问题的本质

当开发者尝试使用Object.values()等ES2017引入的新API时遇到类型错误，这是因为recommended配置没有预设任何lib编译器选项。TypeScript默认情况下会根据target选项推断基本的运行时库，但不会自动包含较新的ES特性。

解决方案

要解决这个问题，开发者需要明确指定项目所需的ECMAScript特性支持级别。有以下几种常见做法：

1. 单独设置lib选项：在tsconfig.json中显式声明需要的特性库

{
  "compilerOptions": {
    "lib": ["es2017"]
  }
}

2. 使用组合配置：将recommended与其他配置组合使用

{
  "extends": [
    "@tsconfig/recommended/tsconfig.json",
    "@tsconfig/es2017/tsconfig.json"
  ]
}

3. 根据目标环境调整：如果目标是现代浏览器或Node.js的最新版本，可以直接指定更高的ES标准

{
  "compilerOptions": {
    "target": "es2017"
  }
}

最佳实践建议

1. 明确运行时环境：首先要确定代码将在什么环境中运行，不同环境支持的ES特性不同

2. 渐进式采用：对于库项目，考虑使用较低的ES标准以保证兼容性；对于应用项目，可以根据实际运行环境选择较新的标准

3. 类型检查与运行时分离：TypeScript的类型检查可以比实际运行环境更严格，这是其优势之一

4. 注意polyfill：即使TypeScript通过了类型检查，某些API在旧环境中仍需要polyfill才能运行

理解TypeScript的配置哲学

TypeScript团队有意将各种配置关注点分离，这使得：

• 类型严格性配置可以独立于目标环境配置
• 项目可以逐步采用更严格的类型检查
• 团队可以共享部分配置而不强制所有项目使用相同的运行时目标

这种设计虽然增加了初始配置的复杂度，但为项目的长期维护提供了更大的灵活性。