JavaScript / TypeScript / 系统课时

target 与 lib

target 与 lib

target 和 lib 经常一起出现,但解决的是两个不同问题:前者决定 TypeScript 输出哪一代 JavaScript 语法,后者决定类型检查时可以使用哪些标准库 API 类型。正确配置它们必须以真实运行环境为依据。

学习目标

  • 区分 target 对 JavaScript 输出语法的影响与 lib 对类型声明的影响
  • 根据浏览器或服务器运行环境选择合理的语言版本
  • 识别“类型检查通过但运行环境不支持 API”的风险

target 决定输出语法级别

target 控制 TypeScript 将部分新语法转换到什么 JavaScript 版本。例如,较低的目标版本可能需要把较新的语法降级成旧写法,而较新的目标版本则能够保留更多现代语法。

如果运行环境已经支持 ES2022,可以直接配置:

json
{
  "compilerOptions": {
    "target": "ES2022",
    "strict": true,
    "outDir": "dist"
  },
  "include": [
    "src/**/*.ts"
  ]
}

选择过低的 target 会产生更多转换后的代码;选择高于真实运行环境能力的版本,则可能输出运行时无法解析的语法。因此应依据部署环境,而不是单纯追求最新版本。

lib 决定可见的标准库类型

lib 指定编译器加载哪些标准库声明。例如 ES2022 提供对应 ECMAScript API 的类型,而 DOM 提供 document、window 等浏览器接口的类型。

一个只使用 ES2022 标准能力、不需要浏览器 DOM 类型的配置可以写成:

json
{
  "compilerOptions": {
    "target": "ES2022",
    "lib": ["ES2022"],
    "strict": true,
    "noEmit": true
  },
  "include": [
    "src/**/*.ts"
  ]
}

对应源码可以使用 ES2022 中的 Array.prototype.at:

ts
const values = [10, 20, 30];
const last: number | undefined = values.at(-1);

export { last };

执行类型检查:

bash
npx tsc --noEmit

预期输出:

text
无输出,进程退出码为 0

如果把 lib 降到不包含该 API 声明的版本,编译器就可能报告 at 不存在于数组类型上。这说明 lib 影响的是 TypeScript 对 API 的认识,而不是修改 JavaScript 运行时。

target 与 lib 不负责补齐运行时能力

target 不会自动为缺失的标准库 API 添加 polyfill,lib 更不会向浏览器或 Node.js 注入实现。即使某个 API 因为 lib 配置而通过类型检查,真实运行环境仍必须提供它。

对于浏览器项目,常见配置会同时包含 ECMAScript 和 DOM 类型:

json
{
  "compilerOptions": {
    "target": "ES2020",
    "lib": ["ES2020", "DOM"],
    "strict": true
  }
}

这份配置表示编译器按 ES2020 语法能力处理输出,并允许代码使用 ES2020 标准库与浏览器 DOM 类型。最终是否需要兼容更旧浏览器,还应结合构建工具和 polyfill 策略处理。

按运行环境做选择

确定配置时先回答两个问题:部署环境能直接执行到哪一代 JavaScript,以及代码需要哪些宿主环境 API。前一个问题决定 target,后一个问题决定是否需要 DOM 等额外 lib。

如果没有特殊需求,可以先让 TypeScript 根据 target 使用默认标准库;只有需要明确限制类型环境或补充特定宿主类型时再显式配置 lib。这样能避免类型声明与真实运行环境脱节。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

target 与 lib

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通