如何用TypeScript Record定义仅含部分CountryCode键的类型？

完全可以定义仅包含部分CountryCode键的类型，不需要强制实现全部240个国家的映射。下面提供几种实用方案：

方案1：用Pick筛选需要的键 #

直接通过Pick工具类型从CountryCode中挑选你需要的国家代码，再结合Record定义映射类型：

// 假设CountryCode是libphonenumber导出的类型
import { CountryCode } from 'libphonenumber-js';

interface CountryFormat {
  areaCodeLength: number;
  exampleNumber: string;
}

// 只选中需要启用的国家代码
type EnabledCountries = Pick<CountryCode, 'US' | 'CN' | 'GB'>;

// 定义仅包含选中国家的映射对象
const countryFormats: Record<EnabledCountries, CountryFormat> = {
  US: { areaCodeLength: 3, exampleNumber: '123-456-7890' },
  CN: { areaCodeLength: 3, exampleNumber: '138-0013-8000' },
  GB: { areaCodeLength: 5, exampleNumber: '020-7946-0000' }
};

这种方式下TypeScript会严格校验：你只能定义选中的国家，同时确保所有键都属于合法的CountryCode范围，不会出现非法值。

方案2：Partial结合类型断言（适合渐进式添加） #

如果需要逐步添加国家，不想一开始就固定所有键，可以先用Partial定义可选映射，再通过类型断言转为严格类型：

import { CountryCode } from 'libphonenumber-js';

interface CountryFormat {
  areaCodeLength: number;
  exampleNumber: string;
}

// 先定义部分国家的映射
const partialCountryFormats: Partial<Record<CountryCode, CountryFormat>> = {
  US: { areaCodeLength: 3, exampleNumber: '123-456-7890' },
  CN: { areaCodeLength: 3, exampleNumber: '138-0013-8000' }
};

// 转为仅包含已定义键的严格类型
const countryFormats = partialCountryFormats as Record<'US' | 'CN', CountryFormat>;

后续添加新国家时，只需更新断言里的键列表即可，适合迭代开发场景。

方案3：自定义联合类型（最直观） #

手动列出需要启用的国家代码作为联合类型，同时通过extends确保它是CountryCode的子集，避免输入错误：

import { CountryCode } from 'libphonenumber-js';

interface CountryFormat {
  areaCodeLength: number;
  exampleNumber: string;
}

// 手动指定启用的国家，同时校验是否属于合法的CountryCode
type EnabledCountries = 'US' | 'CN' | 'GB' extends CountryCode ? 'US' | 'CN' | 'GB' : never;

const countryFormats: Record<EnabledCountries, CountryFormat> = {
  US: { areaCodeLength: 3, exampleNumber: '123-456-7890' },
  CN: { areaCodeLength: 3, exampleNumber: '138-0013-8000' },
  GB: { areaCodeLength: 5, exampleNumber: '020-7946-0000' }
};

关键说明 #

Record<K, T>的K只要是CountryCode的子集即可，不需要是完整的联合类型。TypeScript允许用子集约束键，既保证类型合规，又能减少不必要的代码编写。

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