JavaScript / TypeScript / 系统课时

使用模板字面量类型

使用模板字面量类型

当字符串必须遵循固定命名规则时,手写联合类型容易遗漏。模板字面量类型可以把已有键名或联合类型拼接成新的字符串联合,让事件名、字段路径和接口标识在编译阶段就受到约束。

学习目标

  • 理解模板字面量类型如何拼接字符串联合
  • 根据对象键名生成事件名和字段路径
  • 识别宽泛字符串、非字符串键与联合数量膨胀等边界

模板字面量类型的规则

模板字面量类型写在反引号中,并通过 ${类型} 插入字符串字面量联合。若插入位置是联合类型,TypeScript 会对每个成员分别展开;多个位置都是联合时,则会生成它们的笛卡尔组合。

例如,"name" | "age" 放入 ${Key}Changed 后,会得到 "nameChanged" | "ageChanged"。这类类型只存在于编译阶段,不会在运行时自动创建字符串。

主示例:生成事件名与字段路径

下面从 UserForm 的字符串键生成两组固定格式字符串。keyof UserForm & string 会排除可能出现的数字键或符号键,只保留可安全拼接的字符串键。

ts
interface UserForm {
  name: string;
  age: number;
}

type StringKey<T> = keyof T & string;
type ChangeEvent<T> = `${StringKey<T>}Changed`;
type FieldPath<T> = `form.${StringKey<T>}`;

const events: ChangeEvent<UserForm>[] = [
  "nameChanged",
  "ageChanged",
];

const paths: FieldPath<UserForm>[] = [
  "form.name",
  "form.age",
];

// 固定格式之外的字符串会被编译器拒绝
// @ts-expect-error
const invalidEvent: ChangeEvent<UserForm> = "nameUpdated";

for (const value of [...events, ...paths]) {
  console.log(value);
}

预期输出:

text
nameChanged
ageChanged
form.name
form.age

示例中的错误赋值不会进入运行结果;@ts-expect-error 用于确认该行确实应当产生类型错误。删除这条注释后,编译器会直接报告 "nameUpdated" 不能赋给目标联合类型。

关键边界

模板中的插值类型应尽量保持为有限联合。若使用普通 string,结果通常会退化为宽泛字符串格式,例如 ${string}Changed,只能约束后缀,无法枚举具体成员。

当多个插值位置都包含较大联合时,成员数量会快速增长。此时应缩小输入联合、拆分类型,或改用运行时校验,避免编辑器提示和类型检查明显变慢。

内置的 Uppercase、Lowercase、Capitalize 和 Uncapitalize 可以继续转换字符串成员,例如 Capitalize<"name" | "age"> 会得到 "Name" | "Age"。

本课总结

  • 模板字面量类型能把已有联合拼接成固定格式的字符串联合
  • keyof T & string 适合从对象字符串键生成事件名或字段路径
  • 插值联合过大或退化为 string 时,应重新评估类型复杂度

下一课预告

下一课将使用 Partial、Pick、Record 和 ReturnType 等内置工具类型,在不重复声明结构的前提下复用并转换现有类型。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用模板字面量类型

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

登录哪都通