JavaScript / TypeScript / 系统课时
target 与 lib
target 与 lib
target 和 lib 经常一起出现,但解决的是两个不同问题:前者决定 TypeScript 输出哪一代 JavaScript 语法,后者决定类型检查时可以使用哪些标准库 API 类型。正确配置它们必须以真实运行环境为依据。
学习目标
- 区分
target对 JavaScript 输出语法的影响与lib对类型声明的影响 - 根据浏览器或服务器运行环境选择合理的语言版本
- 识别“类型检查通过但运行环境不支持 API”的风险
target 决定输出语法级别
target 控制 TypeScript 将部分新语法转换到什么 JavaScript 版本。例如,较低的目标版本可能需要把较新的语法降级成旧写法,而较新的目标版本则能够保留更多现代语法。
如果运行环境已经支持 ES2022,可以直接配置:
{
"compilerOptions": {
"target": "ES2022",
"strict": true,
"outDir": "dist"
},
"include": [
"src/**/*.ts"
]
}选择过低的 target 会产生更多转换后的代码;选择高于真实运行环境能力的版本,则可能输出运行时无法解析的语法。因此应依据部署环境,而不是单纯追求最新版本。
lib 决定可见的标准库类型
lib 指定编译器加载哪些标准库声明。例如 ES2022 提供对应 ECMAScript API 的类型,而 DOM 提供 document、window 等浏览器接口的类型。
一个只使用 ES2022 标准能力、不需要浏览器 DOM 类型的配置可以写成:
{
"compilerOptions": {
"target": "ES2022",
"lib": ["ES2022"],
"strict": true,
"noEmit": true
},
"include": [
"src/**/*.ts"
]
}对应源码可以使用 ES2022 中的 Array.prototype.at:
const values = [10, 20, 30];
const last: number | undefined = values.at(-1);
export { last };执行类型检查:
npx tsc --noEmit预期输出:
无输出,进程退出码为 0如果把 lib 降到不包含该 API 声明的版本,编译器就可能报告 at 不存在于数组类型上。这说明 lib 影响的是 TypeScript 对 API 的认识,而不是修改 JavaScript 运行时。
target 与 lib 不负责补齐运行时能力
target 不会自动为缺失的标准库 API 添加 polyfill,lib 更不会向浏览器或 Node.js 注入实现。即使某个 API 因为 lib 配置而通过类型检查,真实运行环境仍必须提供它。
对于浏览器项目,常见配置会同时包含 ECMAScript 和 DOM 类型:
{
"compilerOptions": {
"target": "ES2020",
"lib": ["ES2020", "DOM"],
"strict": true
}
}这份配置表示编译器按 ES2020 语法能力处理输出,并允许代码使用 ES2020 标准库与浏览器 DOM 类型。最终是否需要兼容更旧浏览器,还应结合构建工具和 polyfill 策略处理。
按运行环境做选择
确定配置时先回答两个问题:部署环境能直接执行到哪一代 JavaScript,以及代码需要哪些宿主环境 API。前一个问题决定 target,后一个问题决定是否需要 DOM 等额外 lib。
如果没有特殊需求,可以先让 TypeScript 根据 target 使用默认标准库;只有需要明确限制类型环境或补充特定宿主类型时再显式配置 lib。这样能避免类型声明与真实运行环境脱节。