如何定义包含指定字符串值、其余为任意字符串的TypeScript类型？

问题场景 #

你需要定义一种类型，包含指定的字符串字面量值，同时允许任意其他字符串。但遇到以下情况：

• 当类型与number联合时，VSCode能正常显示字面量的代码提示
• 当类型与string联合时，代码提示会失效，因为TypeScript会将联合类型直接简化为string

解决方案 #

方法1：用string & {}替代直接的string #

这种方式既能保留指定字符串字面量的代码提示，又支持任意字符串输入：

// 示例：包含"foo"、"bar"，同时接受任意其他字符串
type CustomStringType = "foo" | "bar" | (string & {});

方法2：使用模板字符串类型 #

如果需要对字符串格式有更灵活的控制，模板字符串类型也能实现相同效果：

type CustomStringType = "foo" | "bar" | `${string}`;

原理说明 #

直接写"foo" | string时，TypeScript会将其简化为string——因为所有字符串字面量都是string的子类型，联合后会被"吸收"。而string & {}或${string}是与string兼容但不会被类型系统简化的特殊类型，能让TypeScript保留联合中的字面量成员，从而维持代码提示功能。

内容的提问来源于stack exchange，提问作者flyflydogdog