如何在TypeScript中定义以指定前缀开头的字符串类型

嘿，我懂你想要的效果——不用限定整个字符串，只要求它必须以指定的几个前缀之一开头，后面随便加内容对吧？你之前用as const锁定固定字符串集合的思路很赞，但这次的需求更灵活，咱们用TypeScript的模板字面量类型就能完美解决！

具体实现步骤 #

首先，先把你的前缀集合用as const定义成只读字面量数组，这样TypeScript能精准识别每个前缀的具体类型：

// 定义你需要的所有前缀
const allowedPrefixes = ['prefix1', 'prefix2', 'prefix3'] as const;

然后创建MyPrefixTypes类型，通过模板字面量把每个前缀和任意字符串拼接起来：

// 生成前缀约束类型：必须以allowedPrefixes中的某一个开头，后面可跟任意字符
type MyPrefixTypes = `${typeof allowedPrefixes[number]}${string}`;

这里的typeof allowedPrefixes[number]会自动提取数组里所有前缀的联合类型（也就是'prefix1' | 'prefix2' | 'prefix3'），再结合${string}就表示前缀后面可以跟任意字符串内容——包括空字符串哦，也就是说只写前缀本身也是符合要求的。

验证示例 #

来看看实际使用的效果，符合要求的不会报错，不符合的TypeScript会直接提示类型错误：

// ✅ 完全合法的示例
const validStr1: MyPrefixTypes = 'prefix1blablabla';
const validStr2: MyPrefixTypes = 'prefix2-hello-world';
const validStr3: MyPrefixTypes = 'prefix3'; // 只写前缀也没问题

// ❌ 这些会触发类型报错，因为前缀不符合要求
const invalidStr1: MyPrefixTypes = 'incorrectprefixblablabla';
const invalidStr2: MyPrefixTypes = 'prefix4oops';

额外小技巧 #

如果想要强制前缀后面必须至少有内容（不能只写前缀），可以额外定义一个非空字符串类型，然后替换掉上面的string：

type NonEmptyString = string & { __nonEmpty: never };
type MyPrefixTypesWithContent = `${typeof allowedPrefixes[number]}${NonEmptyString}`;

// 这个会报错，因为只有前缀没有后续内容
const invalidStr: MyPrefixTypesWithContent = 'prefix1';

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